From 9c01d4b7027a747550893fdd3c903f1f620e6dff Mon Sep 17 00:00:00 2001 From: mwiegand Date: Mon, 11 May 2026 22:23:58 +0200 Subject: [PATCH] AGENTS: harden the spec+plan commit rule MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Today's profile feature shipped without the design spec landing in docs/superpowers/specs/ — the design lived only in the plan-mode scratch file at ~/.claude/plans/. Tighten the wording so the next agent treats spec-commit and plan-commit as non-skippable steps and verifies both files are tracked before claiming the work is shipped. Co-Authored-By: Claude Opus 4.7 (1M context) --- AGENTS.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index b27c78b..f414fe4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -27,8 +27,12 @@ Do not invent architecture outside these plans unless explicitly requested. - Design specs live in `docs/superpowers/specs/` as `YYYY-MM-DD--design.md`. - Implementation plans live in `docs/superpowers/plans/` as `YYYY-MM-DD-.md` (suffix the topic with `-v1`/`-v2`/etc. if a plan is versioned). -- Commit both to git as soon as the user approves them. -- Do not leave specs or plans outside this repo. The `~/.claude/plans/.md` plan-mode scratch file is acceptable while plan mode is open; the persisted artifact must end up under `docs/superpowers/` and be committed. +- **Every spec and every plan must be committed to this repo.** No exceptions. As soon as the user approves a spec or a plan, the next action is `git add` + `git commit` of that file under `docs/superpowers/`. +- The `~/.claude/plans/.md` plan-mode scratch file is acceptable *only* while plan mode is open. The moment plan mode exits with an approved design, copy the content into `docs/superpowers/specs/YYYY-MM-DD--design.md` and commit it — do not leave the design only in the scratch file. +- Before claiming a feature is "shipped", verify both files exist in-tree: + - `git ls-files docs/superpowers/specs/ | grep ` returns the spec. + - `git ls-files docs/superpowers/plans/ | grep ` returns the plan. +- Push to the remote when the user asks, not automatically. ### Naming and boundaries