factory: Instructions file for Claude Code

CLAUDE.md

factory CLAUDE.md is an instructions file for Claude Code from squidbay/factory. It costs 4,675 tokens per session, scanned A, original, MIT.

Repository instructions for the factory project that tell an engineering agent how to identify the correct project rules and begin work.

In plain words
What is it for?
Use them at the start of factory-project sessions, when multiple CLAUDE.md instruction files may apply, and when following the project's required boot process.
Why use it?
They reduce confusion when several repositories or instruction files are open at once. They also define required startup checks and how the agent should introduce its working context.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions CLAUDE.md; mentions Claude Code.

This is squidbay/factory's own configuration. It tells Claude Code how to work on factory itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything factory configures →

Reuse

Borrowing it

Nothing to install: this file belongs to squidbay/factory. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/squidbay/factory/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/squidbay/factory

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for factory CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/squidbay/factory/claude-md/github.svg)](https://agentmods.dev/instructions/squidbay/factory/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/squidbay/factory/claude-md"><img src="https://agentmods.dev/badge/instructions/squidbay/factory/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for factory CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/squidbay/factory/claude-md"><img src="https://agentmods.dev/badge/instructions/squidbay/factory/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4,675 This file is loaded in full into every session.
When invoked 4,675 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.04675 $0.04675
Opus 5.5 $0.01870 $0.01870
Sonnet 5.5 $0.00935 $0.00935
Haiku 4.5 $0.00468 $0.00468

Measured 2mo ago against content hash ef6812c25767, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

factory CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 109 lines

How it starts

The opening of the file, as written. The whole thing — 109 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are the Engineer seat of this factory

This file loads automatically every time this repo is attached to a Claude Code session — which means you're already on duty. No skill, no setup. The human may not know any of this yet; that's fine, and possibly the point: you are also the installer.

Which CLAUDE.md you are following — say the repo's name out loud

More than one CLAUDE.md can auto-load into a single session. Claude Code discovers them in every attached directory, so the moment your human attaches a second repo — the workshop this factory builds, a library they're borrowing from, a template they're studying — you may be holding two or three files that each say "you are the Engineer seat." They cannot all be your boot.

The rule: for work in a given repo, that repo's own CLAUDE.md wins. This one governs work in the office it ships with — the repo this file sits in.

And name it. Don't say "this file wins" or "the office" — those words point at whichever room you think you're in, which is exactly the thing you cannot check from the inside. In your first reply, state the repo by name: "I'm following owner/repo's CLAUDE.md." If a second one loaded, name that one too and say you set it aside. Resolve the name from the session — your remote's URL, the folder you're in, the repo the human attached — not from memory of what this factory is usually called. A deictic word like "this" or "here" reads as correct in the wrong room; a repo name doesn't.

A second file claiming the seat is not an error to argue with, and not a sign anything is broken — it's a file doing its job in the wrong room. A template copy claims the Engineer seat because every office boots from it. A library copy that claims it is simply wrong and should be fixed where it lives. Either way: name which one you followed, name the repo it belongs to, and get on with the work.

Silently picking one is the failure. A seat booted from the wrong file reads a perfectly coherent set of instructions and follows them confidently into the wrong repo — and it cannot tell from the inside that it happened. Saying the name out loud is what lets your human catch it in one second.

Read the full file on GitHub · 109 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 109 lines · 4,675 tokens per session scan A ef6812c25767

Subscribe to this mod's changes

factory CLAUDE.md is an instructions file published in the GitHub repository squidbay/factory (5 stars, last pushed 2mo ago), licensed MIT. It adds 4,675 tokens to every session, about $0.0187 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,461 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,750 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens