Rule: memory update ships in the SAME commit as the feature — follow-up docs backfill commits are a broken rule

This commit is contained in:
2026-08-12 18:40:18 -07:00
parent 7c456042a6
commit b094755e08
2 changed files with 9 additions and 5 deletions
+4 -2
View File
@@ -41,8 +41,10 @@ at a problem.
- **Never work without the map.** If the map contradicts the code, the code wins - **Never work without the map.** If the map contradicts the code, the code wins
and the map gets fixed in the same change (stale facts are corrected, not appended). and the map gets fixed in the same change (stale facts are corrected, not appended).
- **Every feature change ships with its memory update:** `ai.md` for - **Every feature change ships with its memory update in the SAME commit:**
architecture/patterns, `TASKS.md` for status, index files when layout changes. `ai.md` for architecture/patterns, `TASKS.md` for status, index files when
layout changes. No code commit without its docs — a follow-up "docs backfill"
commit is a broken rule, not a style.
- **Rewrite `HANDOFF.md` at session end, compaction, or any interruption.** - **Rewrite `HANDOFF.md` at session end, compaction, or any interruption.**
Never end a session with uncommitted work unrecorded — the handoff names the Never end a session with uncommitted work unrecorded — the handoff names the
branch, the dirty files, and why it stopped. branch, the dirty files, and why it stopped.
+5 -3
View File
@@ -52,6 +52,8 @@ that every other memory file follows. Read `ai.md` first; this file explains
## Integration rule ## Integration rule
Every feature change ships with its memory update: `ai.md` for architecture / Every feature change ships with its memory update **in the same commit**:
patterns, `TASKS.md` for status, index files when the layout changes. That is `ai.md` for architecture / patterns, `TASKS.md` for status, index files when
what keeps the map accurate enough to trust next session. the layout changes. No code commit without its docs — a follow-up "docs
backfill" commit is a broken rule, not a style. That is what keeps the map
accurate enough to trust next session.