Sitemap
Every page on ccmd, grouped by section. 48 pages total.
About1
Alternatives1
Faq1
How It Works1
Karpathy Rules1
Privacy1
Sitemap1
Guides40
- Cutting the CLAUDE.md rules Claude ignores (and the ones to keep)The popular fix for a rule Claude keeps skipping is to delete it. That is backwards for most of them. ccmd's analyzer attaches a tokenSavings number to every finding, and that number is the cut-vs-keep verdict: full line means cut, 35 percent means split, zero means the rule matters and was ignored because of how it reads. Reshape those, do not delete them.2026-05-22
- AGENTS.md design decisions: the seven choices baked into the spec, and what each one costs you per turnAGENTS.md picked plain markdown, a single root file, no required fields, no @-import, nested concatenation, and a 32 KiB cap. Each decision has a measurable consequence in tokens, cache behavior, or loader semantics. Here is each one, what it bought, and what it cost.2026-05-21
- Audit the silent token cost of your CLAUDE.md: four surcharges your bill never breaks outYour provider's usage page shows one number per day. It never says which line of which CLAUDE.md cost you what. The audit lives one layer down: four token surcharges (cache_bust, duplicate, bloat, dead-rule waste) that fire on every turn with no log entry. ccmd's analyzer prints them by line number on the file you paste.2026-05-21
- CLAUDE.md token bloat: the precise definition, the 28-word line, and the six things it is notReddit threads use 'token bloat' as a vague complaint. ccmd's analyzer treats it as one named finding with one rule: any line over 28 words, credited at 35% recovery (not 100%). Six other findings (cache_bust, duplicate, vague, aspirational, missing_why, conflict) look like bloat but are scored separately. The source code, the math, and why the savings number is conservative.2026-05-21
- Hooks block tool calls. CLAUDE.md rules ask nicely.A PreToolUse hook returning permissionDecision: "deny" stops the tool call in the Claude Code harness before the model is queried. A CLAUDE.md line saying the same thing is advisory text the model can comply with, partially comply with, or skip. Here is the exact JSON shape, a four-question test to decide where any rule belongs, and the one limit no other guide writes down honestly.2026-05-21
- Shared CLAUDE.md token cost in parallel: one bloated line is billed once per seat, at onceA shared CLAUDE.md is not paid once. It is re-injected every turn of every session that loads it, so a team of M engineers working in parallel pays your per-turn token count M times simultaneously. The per-turn number ccmd prints is the per-seat floor; your headcount is the multiplier nobody puts on it. Here is the math, where the file gets re-paid, and how to attribute it per engineer.2026-05-21
- AGENTS.md token audit cost: the four-step procedure and the one step everyone skipsAn AGENTS.md token cost audit is four steps: paste, score, read three numbers, calibrate to your loader. Most audits stop at step three. The score itself is free (no signup, no upload, ~250ms in your browser). The dollar number you read off the screen is the upper bound for one specific path: Codex CLI, uncached, 30 turns, Opus 4.7 at $15 per million input tokens. Your actual bill is that number times your loader's fire rate.2026-05-20
- AGENTS.md token cost per turn: one file, four hosts, four different billsAGENTS.md does not have one per-turn token cost. The same 640-byte file is 0 tokens per turn in Cursor, 0 in Claude Code without an @-import, the entire file in Claude Code with @AGENTS.md, the entire file in Codex CLI on uncached turns, and ~10% of the file on cached Codex turns. The number belongs to the host, not the file.2026-05-20
- Claude Code config is project-specific by design. Here are the seven anchor points that bind it to your tree.A Claude Code config is not a portable artifact. CLAUDE.md is a contract with seven specific anchor types in your project tree: file paths, scripts, .claude/settings.json hooks and MCP allowlist, @import targets, subdir CLAUDE.md, incident references, and stack lines. Copy it to another repo and each one breaks silently. Where each rule actually belongs, and what transfers vs. what doesn't.2026-05-20
- Claude Code context cost scales quadratically (the real math)Raw input grows as N(N+1)/2 across N turns, not linearly. At 200 turns that's a 100x session multiplier. Prompt caching only saves you if the CLAUDE.md prefix stays stable.2026-05-20
- CLAUDE.md accuracy gain audit: turn rubricPassed into a mistake-rate numberEvery CLAUDE.md audit on the internet measures tokens cut. An accuracy gain audit measures accuracy bought. It converts ccmd's rubricPassed score (0 to 12) into an expected mistake-rate reduction using the published Karpathy-12 baseline of 41% to 11%, then ranks the rules you fail by marginal gain per added token.2026-05-20
- CLAUDE.md instruction token threshold: 28 words per rule, not 2,500 per fileEvery CLAUDE.md guide quotes the file-level ceiling. The threshold that actually predicts ignored rules is per instruction, not per file. The ccmd analyzer fires at wordCount > 28, roughly 37 tokens per line, and credits back 35% of the line's tokens as recoverable savings. The source line, the math, and what happens above the threshold.2026-05-20
- CLAUDE.md plugin overwrite risk: the Edit tool is already on your file, by defaultAnthropic's official claude-md-management plugin ships a skill whose frontmatter lists Edit as an allowed tool and whose body literally says 'this skill can write to CLAUDE.md files.' The user-approval guardrail is the only thing in the way, and three ordinary configs disable it. A second vector: shared marketplaces with auto-update on let a teammate ship a plugin that gains Edit on your CLAUDE.md without re-asking for trust.2026-05-20
- CLAUDE.md silent failure audit: 7 line shapes that fail without a logCLAUDE.md is the only piece of config in your stack that fails silently. TypeScript yells, ESLint yells, CI yells. CLAUDE.md ships every byte to Claude on every turn and then says nothing when half the rules get ignored. The audit is 7 deterministic checks against the bytes you wrote, each one a finding kind at a known line in src/lib/analyzer.ts.2026-05-20
- CLAUDE.md template token cost: the recurring annuity nobody quotesA starter template's token cost is not a one-time fee. It is the cost of those tokens times every turn times every session for the life of the project. At Opus 4.7's $5/M input rate, a 2,000-token template runs about $0.010 per turn uncached and $75 a year at five sessions a week. Here is the math, the source line that proves the file fires on 100% of turns, and measured numbers for common template shapes.2026-05-20
- Cross-model CLAUDE.md drift: the same file does not cost the same on Opus, Sonnet, and HaikuType /model in Claude Code and the file on disk does not change. The bill it produces, the rules it is allowed to enforce, and the cache it lives in all do. Most analyzers normalize cost to Opus, including ours, so the number you stare at is one specific model's slice of the truth. Here is the math and the line in the analyzer that fixes it.2026-05-20
- Subagent CLAUDE.md inheritance cost: you inherit the bill, not the brainEvery custom subagent loads your full CLAUDE.md hierarchy at startup as a fresh read, and there's no frontmatter field to disable it. A 'tiny' subagent that runs echo success burns ~60k tokens with normal inheritance vs ~3k tokens with none. The inheritance is binary, unconfigurable, and bills the static layers without passing along anything the parent already paid to compute.2026-05-20
- Claude memory audit: 8 checks that cover both files Claude reads every turnA Claude memory audit walks two files in order: CLAUDE.md (the one you wrote, ships every byte every turn) and MEMORY.md (the one Claude wrote about you, first 200 lines load every turn). Here are the seven CLAUDE.md finding kinds the analyzer checks, the one MEMORY.md check the analyzer does not yet ship, and the order to run them in under ten minutes.2026-05-19
- Score the CLAUDE.md and AGENTS.md files you never auditedWe ran ccmd's analyzer on five hand-written config files that had never been audited: three CLAUDE.md, one AGENTS.md, one .cursorrules. Every one scored 2 out of 12 on the 12-rule rubric and missed the exact same ten rules. Here is the baseline, why it is always roughly that number, and how to score your own files in about a quarter second.2026-05-19
- AGENTS.md and CLAUDE.md import drift: when @AGENTS.md silently doubles in sizeIf your CLAUDE.md is one line that reads @AGENTS.md, you are not looking at what Claude sees. Anthropic's docs document the @-import syntax with a 5-hop recursion limit. The drift is that the pointer stays one line while the target grows, and most analyzers score the pointer.2026-05-18
- AGENTS.md host context drift: one file, four loaders, four different system promptsAGENTS.md is positioned as a portable spec across coding agents. The spec is intentionally one paragraph. Every host then fills in the gaps differently. Same file on disk, four different in-context payloads.2026-05-18
- Claude Code auto memory tokens: what MEMORY.md actually costs per turn, measured on a real machineAuto memory is the cousin of CLAUDE.md every audit forgets. MEMORY.md fires on every turn but only the first 200 lines load; the rest sit on disk invisible to Claude. On a real long-lived index of 1,135 lines, only 21,677 chars (~5,400 tokens) bill per turn. Here is what that looks like on disk, what the truncation does, and how to think about the per-file follow-read cost.2026-05-18
- Claude Code config audit: the 12-rule scorecard your file gets graded onA Claude Code config audit is a line-by-line score of your CLAUDE.md (or AGENTS.md, .cursorrules, .grokrules) against the Karpathy 12-rule rubric, plus seven per-line finding kinds (bloat, vague, aspirational, conflict, duplicate, missing_why, cache_bust). The rubric is what makes it an audit instead of advice.2026-05-18
- Claude Code cost is set by context, not by which model you pickedSwitching Opus to Haiku caps the bill at 5x cheaper. A bloated CLAUDE.md moves it 4-10x. One cache-busting line in your config flips you from $0.50/M to $5/M at the same model, a 10x swing the model-pricing table never shows. The dial is context.2026-05-18
- Claude Code feels slow? Config bloat is a latency tax, not just a billing oneEvery byte of CLAUDE.md re-uploads on every turn and feeds time-to-first-token. One date in the first 20 lines forces every session to pay the uncached TTFT instead of a cached-read TTFT. The two analyzer findings that double as latency findings, and the fixes.2026-05-18
- claude-code-setup plugin token cost: what fires every turn vs only on invokeAnthropic's official claude-code-setup plugin is one read-only skill. We measured its actual on-disk size, separated the per-turn discovery payload (the YAML frontmatter, ~78 tokens) from the on-invocation body (~2,700 tokens for SKILL.md plus up to ~7,900 more for references), and pointed at the cost the install guides never mention: the configs it asks you to add.2026-05-18
- CLAUDE.md conditional rules: there is no syntax for themThere is no inline conditional rule syntax in CLAUDE.md. Every line is concatenated into the system prompt at session start and fires on every turn. The five 'if/when/for X then Y' shapes people write inside CLAUDE.md still fire every turn; they just spend tokens to describe a condition the prompt cannot enforce. The three real conditional surfaces are nested CLAUDE.md (path-scoped), skills (intent-scoped), and hooks (event-scoped).2026-05-18
- CLAUDE.md cost with parallel agents: which surfaces multiply, and the two that do notFan out N parallel agents in Claude Code and your CLAUDE.md cost usually multiplies by N. Anthropic's own docs put agent teams at ~7x a standard session because each teammate loads CLAUDE.md, MCP servers, and skills from scratch. Two built-in subagents, Explore and Plan, are the one exception: they skip CLAUDE.md. The surface-by-surface multiplier table, and how to apply ccmd's per-turn token number to your real fan-out.2026-05-18
- CLAUDE.md for a solo founder: the three rules to lead withA solo founder's CLAUDE.md does a different job than a team's. There is no second reviewer, so the file has to encode its own correction loop. Three Karpathy rules (#5 Avoid Silent Assumptions, #11 Failure Mode Coverage, #12 Self-Improvement Loop) carry most of the weight, and they are the three most CLAUDE.md files we score fail. Here is a minimal template that passes, with the audit math.2026-05-18
- CLAUDE.md owner audit: find the stale lines nobody owns anymoreAn owner audit pairs git blame CLAUDE.md (who added each line, when) with a deterministic line-level analyzer. ccmd flags the three fingerprints stale lines leave behind: a stale timestamp, a duplicate rule, and a prohibition with no recorded reason. A repo grep and git blame name what is gone and who to ask.2026-05-18
- CLAUDE.md per-turn token cost: the lookup table by file sizeYour CLAUDE.md is re-sent in full on every turn, so its per-turn token cost equals its whole token count. This is a flat number you can read off a table: characters / 4 = tokens, tokens x rate = dollars. Per-turn and per-session cost by file size at Opus 4.7, Sonnet 4.6, and Haiku 4.5 rates, plus the chars/4 vs new-tokenizer gap.2026-05-18
- CLAUDE.md token waste per turn: the seven categories of bytes billed for nothingEvery byte of CLAUDE.md is in the system prompt on every turn. Seven categories of those bytes produce zero behavioral signal. Our analyzer enumerates them as the Finding.kind union at src/lib/analyzer.ts:6. Per-category waste math, ranked by dollar impact, on Opus 4.7 at the rate the analyzer hardcodes.2026-05-18
- CLAUDE.md vs AGENTS.md vs .cursorrules drift: how to actually measure itIf your repo has CLAUDE.md, AGENTS.md, and .cursorrules side by side, they have already drifted. The trick is that drift is measurable: the same Karpathy 12-rule rubric runs against all four formats, so a 7/12 CLAUDE.md next to a 3/12 .cursorrules is a literal 4-rule delta. The missing rules in the gap are where Claude and Cursor silently behave differently.2026-05-18
- CLAUDE.md weekly quota burn: the seven-day math that hits you on WednesdayPer-turn token math hides what your CLAUDE.md actually costs you. The bill that throttles you is weekly. One 6,000-token file × five sessions × five days × thirty turns is 4.5 million input tokens before Claude has read a single line of your code. One ISO date on row 3 multiplies that by ten. The walkthrough, with the line of the analyzer that catches it.2026-05-18
- Do CLAUDE.md rules fire on every turn? Yes, and the fix isn't cutting bytes.Every line of CLAUDE.md is concatenated into the system prompt and re-sent on every turn. Our analyzer hardcodes that as estimatedTokensFireEveryTurn = totalTokens. But CLAUDE.md is one of four firing surfaces, and the other three (skills, hooks, MCP tool descriptions) fire conditionally. A walkthrough of which surface each kind of rule belongs on.2026-05-18
- Layered CLAUDE.md token cost: the file you pasted is one layer of the billAn analyzer scores one pasted CLAUDE.md. Claude Code concatenates a stack at launch: managed policy, ~/.claude/CLAUDE.md, the project file, and every @import it pulls. Worked on ccmd's own repo, where an 11-byte CLAUDE.md sits on a ~4,980-token per-turn floor. How to add up your real layered cost.2026-05-18
- Nested CLAUDE.md token scope: when a subdirectory file actually costs youA nested CLAUDE.md costs zero tokens at launch, the full file the moment Claude reads anything in its subtree, then zero again after /compact. The four token states of a subdirectory file, and why other guides stop at the first one.2026-05-18
- A config analyzer for .grokrules (and .grok/GROK.md)Paste a .grokrules or .grok/GROK.md file and get a per-line score: Karpathy 12-rule pass rate, bloat, vague terms, missing-why prohibitions, cache-busting timestamps. Same rubric ccmd runs on CLAUDE.md, because Grok Build copied the format.2026-05-17
- CLAUDE.md context burn audit: the seven things to actually gradeMost guides say 'audit your CLAUDE.md' and stop at advice. ccmd's analyzer fires seven specific checks on every paste (bloat 28+ words, 14 vague terms, 6 absolute words, ISO date in first 20 lines, duplicate, missing-why, conflict) plus the Karpathy 12-rule scorecard. The cache-bust check is the one no other audit catches and the one with the largest dollar impact.2026-05-17
- Agent-config guides: CLAUDE.md, AGENTS.md, .cursorrules, .grokrulesLong-form guides on the agent-configuration files that ship into your context on every turn. Token cost math, Karpathy-rubric scoring, rule-firing audits, AGENTS.md / .cursorrules / .grokrules comparisons, drift across models. Grouped by topic.