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

2026-08-12 18:40:18 -07:00
parent 7c456042a6
commit b094755e08
2 changed files with 9 additions and 5 deletions
@@ -41,8 +41,10 @@ at a problem.

 - **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).
- **Every feature change ships with its memory update:** `ai.md` for
-  architecture/patterns, `TASKS.md` for status, index files when layout changes.
+- **Every feature change ships with its memory update in the SAME commit:**
+  `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.**
  Never end a session with uncommitted work unrecorded — the handoff names the
  branch, the dirty files, and why it stopped.