From bcd174f89e3d2951e10fa76e28a7f99020d79406 Mon Sep 17 00:00:00 2001 From: Jason Woltje Date: Mon, 10 Aug 2026 16:20:26 -0500 Subject: [PATCH] docs: archive stale TUI records --- docs/DEVELOPER-GUIDE/README.md | 4 ++-- docs/SITEMAP.md | 1 + docs/archive/README.md | 20 +++++++++++++++++++ .../{ => archive/tui}/PRD-TUI_Improvements.md | 0 .../tui}/TASKS-TUI_Improvements.md | 0 docs/scratchpads/DOCS-IA-002-catalog-audit.md | 3 +++ 6 files changed, 26 insertions(+), 2 deletions(-) create mode 100644 docs/archive/README.md rename docs/{ => archive/tui}/PRD-TUI_Improvements.md (100%) rename docs/{ => archive/tui}/TASKS-TUI_Improvements.md (100%) diff --git a/docs/DEVELOPER-GUIDE/README.md b/docs/DEVELOPER-GUIDE/README.md index 8a84f9d1..d1614dd3 100644 --- a/docs/DEVELOPER-GUIDE/README.md +++ b/docs/DEVELOPER-GUIDE/README.md @@ -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. diff --git a/docs/SITEMAP.md b/docs/SITEMAP.md index ff73b9cf..260808b7 100644 --- a/docs/SITEMAP.md +++ b/docs/SITEMAP.md @@ -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. diff --git a/docs/archive/README.md b/docs/archive/README.md new file mode 100644 index 00000000..2d09ee0b --- /dev/null +++ b/docs/archive/README.md @@ -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. diff --git a/docs/PRD-TUI_Improvements.md b/docs/archive/tui/PRD-TUI_Improvements.md similarity index 100% rename from docs/PRD-TUI_Improvements.md rename to docs/archive/tui/PRD-TUI_Improvements.md diff --git a/docs/TASKS-TUI_Improvements.md b/docs/archive/tui/TASKS-TUI_Improvements.md similarity index 100% rename from docs/TASKS-TUI_Improvements.md rename to docs/archive/tui/TASKS-TUI_Improvements.md diff --git a/docs/scratchpads/DOCS-IA-002-catalog-audit.md b/docs/scratchpads/DOCS-IA-002-catalog-audit.md index 046dbc6a..b3779acb 100644 --- a/docs/scratchpads/DOCS-IA-002-catalog-audit.md +++ b/docs/scratchpads/DOCS-IA-002-catalog-audit.md @@ -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 |