docs: archive stale TUI records

2026-08-10 16:20:26 -05:00
parent 94fc3e55f5
commit bcd174f89e
6 changed files with 26 additions and 2 deletions
@@ -28,8 +28,8 @@ Every promoted page must be added to this index and to [`SITEMAP.md`](../SITEMAP

 These are source candidates or stale records, not verified current instructions:

- [`PRD-TUI_Improvements.md`](../PRD-TUI_Improvements.md) — contradicted/stale; it references a missing `packages/cli`, while current TUI code is under `packages/mosaic`.
- [`TASKS-TUI_Improvements.md`](../TASKS-TUI_Improvements.md) — historical task ledger; its status and worktree claims require revalidation.
+- [`archived TUI PRD`](../archive/tui/PRD-TUI_Improvements.md) — contradicted/stale; it references a missing `packages/cli`, while current TUI code is under `packages/mosaic`.
+- [`archived TUI task ledger`](../archive/tui/TASKS-TUI_Improvements.md) — historical task ledger; its status and worktree claims require revalidation.
 - [`_old_structure/guides/dev-guide.md`](../_old_structure/guides/dev-guide.md) — historical source; verify paths and commands before promotion.
 - [`_old_structure/architecture/`](../_old_structure/architecture/) — historical architecture sources; classify each page before migration.

@@ -12,6 +12,7 @@
 - [API documentation index](API/README.md) — scaffold for the consolidated gateway contract.
 - [Documentation catalog and truth audit](reports/documentation/2026-08-10-docs-catalog-audit.md) — evidence and migration recommendations.
 - [P8-003 performance report](reports/qa/p8-003-performance-optimization.md) — historical performance evidence; not a current SLO or runbook.
+- [Archive index](archive/README.md) — retained historical pages; not current guidance.

 Canonical pages added to a book must be linked from that book's README and this section. Replace or retire legacy entries only after the associated migration slice verifies repository references and claim status.

@@ -0,0 +1,20 @@
+# Documentation Archive
+
+> **Status:** Current archive index. Pages linked here are historical or superseded and are not current product, operator, or developer guidance.
+
+Use [`docs/README.md`](../README.md) for current placement and source-of-truth rules. Historical pages remain discoverable here only when retaining their context is useful; each migration should identify a replacement or explain why the record is retained.
+
+## Archived TUI workstream
+
+The following branch-specific records are retained because their implementation claims and worktree paths no longer match the current checkout:
+
+- [`TUI improvements PRD`](tui/PRD-TUI_Improvements.md) — historical Phase 7 requirements; it names the deleted `packages/cli` package.
+- [`TUI improvements task ledger`](tui/TASKS-TUI_Improvements.md) — historical task/status record; its relative PRD link remains valid within this archive directory.
+
+Do not use these pages as instructions for the current TUI. Current TUI implementation is under `packages/mosaic`; any new requirements require a separately approved plan or PRD.
+
+## Retention rules
+
+- Preserve historical wording unless a migration task explicitly requires a rewrite.
+- Label replacements and current status in the owning index rather than silently reviving archived claims.
+- Do not link archive pages from current workflow instructions as if they were current.
@@ -20,6 +20,7 @@
 - [x] Scaffold audience, architecture, and API indexes without moving legacy content.
 - [x] Add current scaffold entry points to `SITEMAP.md` without rewriting its legacy sections.
 - [x] Select the P8-003 performance report as the first low-risk migration slice.
+- [x] Archive the contradicted TUI PRD/task pair with unchanged content and an explicit archive index.

 ## Initial findings

@@ -35,6 +36,7 @@
 - The scaffold slice adds `USER-GUIDE/README.md`, `ADMIN-GUIDE/README.md`, `ADMIN-GUIDE/security/README.md`, `DEVELOPER-GUIDE/README.md`, `DEVELOPER-GUIDE/architecture/README.md`, and `API/README.md`; legacy pages remain unchanged.
 - `SITEMAP.md` now has a labeled current-structure section; its legacy sections remain unchanged and explicitly transitional.
 - `docs/PERFORMANCE.md` had no live source/test dependency or internal links; it moved unchanged to `docs/reports/qa/p8-003-performance-optimization.md`. The admin index and current sitemap now classify it as historical evidence, not an operator runbook.
+- `PRD-TUI_Improvements.md` and `TASKS-TUI_Improvements.md` had no live source/test dependencies beyond their internal relative link; both moved unchanged to `docs/archive/tui/`, and `docs/archive/README.md` labels them historical.

 ## Method

@@ -68,3 +70,4 @@
 | Sitemap scaffold            | PASS — additive current section is formatted, all seven links resolve, and legacy sections are unchanged                                                          |
 | First migration selection   | PASS — P8-003 report selected as a no-rewrite evidence migration; live references identified before move                                                          |
 | P8-003 migration            | PASS — destination is byte-identical, live references were updated, formatting and navigation checks pass, and only the scoped migration files are pending commit |
+| TUI archive migration       | PASS — both pages are byte-identical, internal links and archive navigation resolve, formatting passes, and only the scoped archive files are pending commit      |