From b094755e084e2c8b8d21c5ee6b8c025ecc1a07a8 Mon Sep 17 00:00:00 2001 From: gramps Date: Wed, 12 Aug 2026 18:40:18 -0700 Subject: [PATCH] =?UTF-8?q?Rule:=20memory=20update=20ships=20in=20the=20SA?= =?UTF-8?q?ME=20commit=20as=20the=20feature=20=E2=80=94=20follow-up=20docs?= =?UTF-8?q?=20backfill=20commits=20are=20a=20broken=20rule?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 6 ++++-- schema.md | 8 +++++--- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index b9b8da1..f33a46f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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. diff --git a/schema.md b/schema.md index 7aa87c3..b191629 100644 --- a/schema.md +++ b/schema.md @@ -52,6 +52,8 @@ that every other memory file follows. Read `ai.md` first; this file explains ## Integration rule -Every feature change ships with its memory update: `ai.md` for architecture / -patterns, `TASKS.md` for status, index files when the layout changes. That is -what keeps the map accurate enough to trust next session. +Every feature change ships with its memory update **in the same commit**: +`ai.md` for architecture / patterns, `TASKS.md` for status, index files when +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.