docs: archive the finished backlogs (RD-30)

Two backlog trees are complete: `docs/project/backlog/` (75 files, every WP done) and `docs/project/refactor-backlog-setup/` (the arc before it). Move both under `docs/project/archive/` with `git mv`, so history stays intact through `git log --follow`. `SHOWCASE-ROADMAP.md` moves with them, because it points at the now-archived backlog README. Add `docs/project/archive/README.md`. It states that these trees are historical and names the two directories that are still live. Repoint every inbound reference named in RD-30's Files table: CLAUDE.md, the root README, both backend READMEs, `LetterHtml.cs`, `a11y.mdx`, the `document-feature` and `new-ssp` skills, and the readable-codebase PLAN, README, and RD-19 ticket. Fix two upward-relative links inside the moved WP files (WP-68, WP-69) that gained a directory level and would otherwise break. Repoint `.prettierignore`'s two agent-prompt exclusions to their new path, so prettier keeps leaving those files' exact wording alone. Mark RD-30 done and check off its acceptance criteria; flip its README row to done. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-08 23:00:38 +02:00
parent 097e8468e0
commit 12f17d9d73
161 changed files with 154 additions and 24 deletions
@@ -0,0 +1,63 @@
+# Refactoring backlog — automated setup
+
+## What's in this package
+
+```
+refactor-backlog-setup/
+  setup.sh                     ← run this once, from the root of the target repo
+  agents/                      ← source prompts (edit these if you need to tweak
+                                  scope/wording before running setup.sh)
+    _persistence-protocol.md
+    00-baseline.prompt.md
+    01-readability.prompt.md
+    02-testability.prompt.md
+    03-ddd-hexagonal.prompt.md
+    04-cqrs-light.prompt.md
+    05-bdd.prompt.md
+    06-adr-conformance.prompt.md
+    07-bio2-compliance.prompt.md
+    08-consolidation.prompt.md
+    09-implementation.prompt.md  (template — one TICKET-ID per Phase 3 dispatch)
+```
+
+## Usage
+
+1. Copy this `refactor-backlog-setup/` folder into the root of the target repo
+   (or reference it via a relative path).
+2. Edit anything in `agents/` if scope/exclusions need repo-specific detail
+   (e.g. exact module paths, ADR folder location) — the prompts currently use
+   the defaults agreed in the design conversation.
+3. Run:
+   ```
+   bash refactor-backlog-setup/setup.sh
+   ```
+   This creates `./refactor-backlog/` with:
+   - `_status.md` initialized, all agents `not_started`
+   - `00-baseline.md` through `07-bio2-compliance.md` initialized with headers
+   - `99-backlog.md` empty, ready for Consolidation
+   - `implementation/` folder for Phase 3 notes
+   - `final-prompts/` — every agent prompt with the persistence protocol
+     already merged in. **These are the exact prompts to dispatch — no manual
+     copy-paste needed.**
+
+## Dispatch order
+
+1. Dispatch `final-prompts/00-baseline.prompt.md` (Opus). Wait for
+   `_status.md` → baseline: complete.
+2. Dispatch the 7 Phase 1 prompts in parallel (Opus): `01` through `07`.
+   Each checks its own dependency in `_status.md` before starting.
+3. Once all 7 show `complete`, dispatch `final-prompts/08-consolidation.prompt.md`
+   (Opus). It writes `99-backlog.md` and halts for human approval — check the
+   file for any `ADR-fix` or BIO2-flagged tickets before proceeding.
+4. For each approved ticket, copy `final-prompts/09-implementation.prompt.md`,
+   fill in `TICKET-ID:`, dispatch (Sonnet). Run tickets in parallel within a CD
+   batch, sequential across batches, per the `Depends on` column in
+   `99-backlog.md`.
+
+## Re-running / resuming
+
+Safe to re-run `setup.sh` only on a fresh workspace — it does not check for an
+existing `./refactor-backlog/` and will overwrite `_status.md` and the phase
+output files. If a run is already in progress, don't re-run `setup.sh`; just
+re-dispatch the relevant `final-prompts/*.prompt.md` — each agent reads
+`_status.md` and its own output file first and resumes from where it left off.