Stop Claude Code memory and bootstrap bloat
Claude Code (or AGENTS.md) has grown into a multi-thousand-line dump and agents are slower, follow it less, or never read the end of it.
Updated November 15, 2026
Short answer: treat bootstrap files as a thin always-on index, and put durable knowledge in reviewed memory cards plus handoffs. BrigadeStack checks bootstrap size budgets, wires handoff inboxes, and (through its memory component) lints dead links and oversize files. For Codex it also reports how many bytes of your instruction chain fit under Codex’s project_doc_max_bytes cap.
The problem
It is easy to paste every preference, runbook, and incident into CLAUDE.md or AGENTS.md. The file becomes the single source of truth and the single failure mode: token waste, stale claims, and lower adherence. Claude Code’s docs say files over 200 lines consume more context and may reduce adherence, Codex stops reading the instruction chain at project_doc_max_bytes (32 KiB by default), and Claude Code’s auto-memory index loads only its first 200 lines or 25KB.
The BrigadeStack path
brigadestack operator quickstart --target . --harnesses claude
brigadestack doctor --target . # bootstrap budgets, card links, handoff inboxes
brigadestack handoff draft --inbox claude ... # durable note, not another CLAUDE.md paragraph
brigadestack ingest --target . --promote-cards
brigadestack add memory # bootstrap-doctor and memory maintenance for deeper audits
Rules of thumb:
- Bootstrap (
AGENTS.md,CLAUDE.md,USER.md,TOOLS.md): short, stable, always loaded. - Cards under
memory/cards/: atomic topics, linked fromMEMORY.md. - Handoffs: session-to-session facts with evidence, then promote or discard.
Related tools
| Tool | Role |
|---|---|
| BrigadeStack doctor | bootstrap size budgets, broken card links, inbox presence, Codex instruction-chain size against project_doc_max_bytes |
| Memory Doctor | dead links, pending handoffs, memory index health |
| Bootstrap Doctor | soft/hard limits on bootstrap files |
| Handoffs compare page | multi-agent handoff path |
When this is enough
Use this layout when bootstrap files keep growing and quality drops. Keep a single personal CLAUDE.md only if it stays under about 200 lines (Claude Code’s own size target) and you have one harness.
Questions
Will BrigadeStack delete my CLAUDE.md? No. Doctor warns and reports budgets. You choose what to split into cards.
Is this only for Claude Code? No. The same slim-bootstrap pattern applies to Codex, Grok, Hermes, and other writers. Claude is just where bloat shows up first for many people.
See how shared memory works and handoff docs.