mirror of
https://github.com/Druthulu/BFM-decomp
synced 2026-10-03 08:07:25 -04:00
Drew T
36 lines
5.2 KiB
Markdown
36 lines
5.2 KiB
Markdown
# Memory Index
|
|
|
|
<!-- decomp-architect memory seed. The kit's installer writes each file below into the project's memory directory
|
|
(`.claude-state/memory/`, the one ProjectArchitect 2.0 configured) and APPENDS these rows to the MEMORY.md that
|
|
ProjectArchitect's seed already created. Each file is a working agreement or a harness fact learned on a finished,
|
|
byte-identical decompilation; the domain rules proper live in the rules registry (canonical) and these are the
|
|
fast-loading complement. Files tagged `upstream: PA` in their frontmatter are harness-generic and belong in
|
|
ProjectArchitect's own seed once it takes them. -->
|
|
|
|
## Already provided by ProjectArchitect 2.0's seed (cited, not duplicated)
|
|
`who-is-dev` · `project-governance-system` · `autonomous-within-phases` · `build-tasklist-after-plan-approval` ·
|
|
`capture-knowledge-before-fresh-session` · `clarify-misconception-before-costly-action` · `justify-new-tools-before-adopting` ·
|
|
`dont-block-loop-with-askuserquestion` · `no-commit-co-author` · `commit-per-task-user-pushes` · `plain-english-recap` ·
|
|
`session-start-rules-in-full` · `worklogs-reference-only` · `keep-ops-current` · `effort-discipline` ·
|
|
`effort-prompt-ultracode-on-breadth` — and the repository-resident state itself (`.claude-state/`, registry rule H8).
|
|
|
|
## The decomp seed
|
|
- [The byte gate is the only claim](the-byte-gate-is-the-only-claim.md) — "matched" means byte-identical output AND a green whole-binary hash; nothing functionally equivalent counts; "banked" is written from a tool's printed line
|
|
- [The matching flywheel](the-matching-flywheel.md) — consult the knowledge base before every match, feed the generalizable lesson back into BOTH the cookbook and the tooling after it
|
|
- [MCP reconnect after restart](mcp-reconnect-after-restart.md) — after restarting the disassembler's MCP server or switching the served program, pause and ask the developer to reconnect the client; the agent cannot
|
|
- [Offline tooling first](offline-tooling-first.md) — every COMPUTABLE step becomes a deterministic zero-token tool; keep deterministic recovery and search separate; ask "is this residual computable?" before reaching for a model
|
|
- [A slow gate is a bug](a-slow-gate-is-a-bug.md) — banking, not drafting, is the bottleneck; nothing in the gate is serial; pass `-j` to every build; measure the gate before fearing it
|
|
- [Breadth is isolated agents](breadth-is-isolated-agents.md) — the main loop's context accumulates roughly quadratically; N isolated agents cost about linearly and run in parallel; hand-by-main-loop wins only for a handful
|
|
- [Route by measured difficulty](route-by-measured-difficulty.md) — tier drafters by a cliff you measured on your own corpus; escalate sooner; the strongest model is for new wall classes, never for reviewing a corpus
|
|
- [One runbook is the procedure](one-runbook-is-the-procedure.md) — one document is the operating procedure for the campaign loop, read before every run, kept current in the same change; a superseded runbook gets a banner
|
|
- [Keep an accelerator ledger](keep-an-accelerator-ledger.md) — every late discovery that would have sped earlier work is recorded with when it was found, when it could have been, and what it would have saved
|
|
- [Checkpoint means everything is already in a file](checkpoint-means-everything-is-already-in-a-file.md) — a checkpoint is the LAST thing written; a good commit message is not in the load order; the sweep before the block
|
|
- [A PhaseEnd carries the narrative axis](phaseend-carries-the-narrative-axis.md) — what was believed, what failed and why it looked right, what it cost, what to do sooner — because transcripts die and the retrospective is rebuilt from the files
|
|
- [Tool change ships with its consumers and docs](tool-change-ships-with-its-consumers-and-docs.md) — the commit that adds a tool also wires its callers and adds its ops row; integrating an agent's tool change IS a tool change; no end-of-session audits
|
|
- [No sleep-polling background tasks](no-sleep-polling-background-tasks.md) — the harness re-invokes on completion; one sanity check after launch, then wait
|
|
- [Long checks run in the foreground](long-checks-run-in-the-foreground.md) — a background long verification can be killed by the harness's memory guard; run it in the foreground with a timeout; check for orphaned workers
|
|
- [Resume means resume the run](resume-means-resume-the-run.md) — replay interrupted work so it finishes itself, same run, same agent, transcript intact; never re-plan or re-route on your own inference
|
|
- [Answer before grinding in live co-op](answer-before-grinding-in-live-coop.md) — only the final message of a turn is guaranteed to be seen; end the turn with the answer the person is waiting on before starting long work
|
|
- [Consult the tool dictionary first](consult-the-tool-dictionary-first.md) — before designing or debugging a tool, look the NEED up in the tool dictionary; the proven implementation is the jumping-off point, its incident row the failure mode to avoid
|
|
- [Translate the source idiom through the pass](translate-the-source-idiom-through-the-pass.md) — an inherited idiom is a symptom + a named pass + a lever + a byte proof; same family: use and re-prove; other compiler: read the same pass in your compiler's source and find your own lever
|