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:
@@ -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.
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|||||||
Reference in New Issue
Block a user