Search BrigadeStack

Search BrigadeStack pages and docs.

BrigadeStack
Menu

Comparisons

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:

  1. Bootstrap (AGENTS.md, CLAUDE.md, USER.md, TOOLS.md): short, stable, always loaded.
  2. Cards under memory/cards/: atomic topics, linked from MEMORY.md.
  3. Handoffs: session-to-session facts with evidence, then promote or discard.
ToolRole
BrigadeStack doctorbootstrap size budgets, broken card links, inbox presence, Codex instruction-chain size against project_doc_max_bytes
Memory Doctordead links, pending handoffs, memory index health
Bootstrap Doctorsoft/hard limits on bootstrap files
Handoffs compare pagemulti-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.