Skip to content

Commit 5927b4c

Browse files
lesnik512claude
andcommitted
chore(docs): update CLAUDE.md workflow for flat changes/ (no folder move)
Replace active/<id>/ with <id>/ in the workflow line. Replace the archive-move instruction with set status/pr/outcome in-branch + run just index. Also update the "Where to find what" pointer that still referenced {active,archive}. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent ba33d7b commit 5927b4c

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

CLAUDE.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,14 @@ Guidance for AI agents (Claude Code, etc.) working in this repository.
1010

1111
- [`architecture/`](architecture/) (repo root) — the per-capability living truth (overview, client, middleware, decoders, errors, resilience, optional extras, testing); the promotion target on every ship. **Read the relevant file before changing that capability.**
1212
- [`planning/README.md`](planning/README.md) — the planning conventions (two axes, change bundles, three lanes, frontmatter) + the change Index.
13-
- [`planning/changes/{active,archive}/<YYYY-MM-DD.NN-slug>/`](planning/changes/) — per-change bundles (`design.md` + `plan.md`, or `change.md` for the lightweight lane).
13+
- [`planning/changes/<YYYY-MM-DD.NN-slug>/`](planning/changes/) — per-change bundles (`design.md` + `plan.md`, or `change.md` for the lightweight lane).
1414
- [`planning/audits/`](planning/audits/) — findings reports + `scripts/` tooling.
1515
- [`planning/retros/`](planning/retros/) — retrospectives.
1616
- [`planning/releases/`](planning/releases/) — per-version release notes (also published on GitHub Releases).
1717
- [`planning/deferred.md`](planning/deferred.md) — review-surfaced, not-yet-actionable items.
1818
- [`planning/_templates/`](planning/_templates/) — design/plan/change templates.
1919

20-
**Per-feature workflow:** brainstorming → `design.md` in `planning/changes/active/<id>/` → writing-plans → `plan.md` in the same bundle → executing-plans (or subagent-driven-development) → requesting-code-review → finishing-a-development-branch. On ship, promote the conclusions into the affected `architecture/<capability>.md` by hand and move the bundle to `planning/changes/archive/`. Topic slugs are kebab-case descriptions (`msgspec-decoder-adapter`), not story IDs.
20+
**Per-feature workflow:** brainstorming → `design.md` in `planning/changes/<id>/` → writing-plans → `plan.md` in the same bundle → executing-plans (or subagent-driven-development) → requesting-code-review → finishing-a-development-branch. On ship, promote the conclusions into the affected `architecture/<capability>.md` by hand and set `status: shipped` + `pr` + `outcome` in the implementing PR — there is no folder move. The change listing is generated: run `just index`. Topic slugs are kebab-case descriptions (`msgspec-decoder-adapter`), not story IDs.
2121

2222
## Commands
2323

0 commit comments

Comments
 (0)