docs(architecture): consolidate canonical docs and archive roadmap noise

docs/subagents/INDEX.md

@@ -57,4 +57,9 @@ Read first. Keep concise.
 | `opencode-task80-ipc-contract-20260222T001728Z-obrv`          | `opencode-task80-ipc-contract`          | `Execute TASK-80 IPC contract typing + runtime payload validation end-to-end without commit`                         | `done`        | `docs/subagents/agents/opencode-task80-ipc-contract-20260222T001728Z-obrv.md`          | `2026-02-22T00:56:00Z` |
 | `opencode-task82-smoke-20260222T002150Z-p5bp`                 | `opencode-task82-smoke`                 | `Execute TASK-82 e2e smoke suite for launcher/mpv/ipc/overlay end-to-end without commit`                             | `done`        | `docs/subagents/agents/opencode-task82-smoke-20260222T002150Z-p5bp.md`                 | `2026-02-22T00:54:29Z` |
 | `codex-task82-smoke-20260222T002523Z-3j7u`                    | `codex-task82-smoke`                    | `Execute TASK-82 e2e smoke suite for launcher/mpv/ipc/overlay end-to-end without commit`                             | `done`        | `docs/subagents/agents/codex-task82-smoke-20260222T002523Z-3j7u.md`                    | `2026-02-22T00:53:25Z` |
-| `opencode-task81-launcher-modules-20260222T005725Z-8oh8`      | `opencode-task81-launcher-modules`      | `Execute TASK-81 launcher command-module/process-adapter refactor end-to-end without commit`                         | `in_progress` | `docs/subagents/agents/opencode-task81-launcher-modules-20260222T005725Z-8oh8.md`      | `2026-02-22T00:57:25Z` |
+| `opencode-task81-launcher-modules-20260222T005725Z-8oh8`      | `opencode-task81-launcher-modules`      | `Execute TASK-81 launcher command-module/process-adapter refactor end-to-end without commit`                         | `done`        | `docs/subagents/agents/opencode-task81-launcher-modules-20260222T005725Z-8oh8.md`      | `2026-02-22T01:09:30Z` |
+| `codex-task99-guardrails-20260222T010930Z-m9q2`               | `codex-task99-guardrails`               | `Execute TASK-99 maintainability guardrail expansion and runtime cycle checks end-to-end without commit`             | `done`        | `docs/subagents/agents/codex-task99-guardrails-20260222T010930Z-m9q2.md`               | `2026-02-22T03:01:34Z` |
+| `opencode-task84-keybindings-gating-20260222T011624Z-llor`    | `opencode-task84-keybindings-gating`    | `Execute TASK-84 gate feature-dependent keybindings behind config flags end-to-end without commit`                   | `done`        | `docs/subagents/agents/opencode-task84-keybindings-gating-20260222T011624Z-llor.md`    | `2026-02-22T01:35:30Z` |
+| `codex-task98-source-tests-20260222T021156Z-a1b2`             | `codex-task98-source-tests`             | `Execute TASK-98 shift core tests to source level and trim dist coupling end-to-end without commit`                  | `done`        | `docs/subagents/agents/codex-task98-source-tests-20260222T021156Z-a1b2.md`             | `2026-02-22T02:36:00Z` |
+| `codex-task101-docs-archive-20260222T024156Z-hneu`            | `codex-task101-docs-archive`            | `Execute TASK-101 consolidate architecture docs and archive task-noise evidence`                                     | `done`        | `docs/subagents/agents/codex-task101-docs-archive-20260222T024156Z-hneu.md`            | `2026-02-22T03:01:38Z` |
+| `codex-fix-ci-20260222T025848Z-0xdl`                          | `codex-fix-ci`                          | `Inspect failing GitHub Actions PR checks and implement approved fix`                                                | `in_progress` | `docs/subagents/agents/codex-fix-ci-20260222T025848Z-0xdl.md`                          | `2026-02-22T02:58:55Z` |

docs/subagents/agents/codex-task101-docs-archive-20260222T024156Z-hneu.md

@@ -0,0 +1,42 @@
+# Agent: codex-task101-docs-archive-20260222T024156Z-hneu
+
+- alias: codex-task101-docs-archive
+- mission: Execute TASK-101 consolidate architecture docs and archive task-noise evidence
+- status: done
+- branch: main
+- started_at: 2026-02-22T02:41:56Z
+- heartbeat_minutes: 5
+
+## Current Work (newest first)
+
+- [2026-02-22T03:01:38Z] handoff: TASK-101 done; backlog AC/DoD checked and status set Done; docs build verified.
+- [2026-02-22T03:01:38Z] change: updated `docs/architecture.md` to remove task-number provenance wording from long-lived architecture rationale.
+- [2026-02-22T03:01:38Z] change: trimmed duplicated architecture guidance in `docs/development.md` Contributor Notes and kept canonical `/architecture` pointer.
+- [2026-02-22T03:01:38Z] change: replaced `docs/structure-roadmap.md` body with archival notice + canonical architecture pointer.
+- [2026-02-22T03:01:38Z] test: `bun run docs:build` pass.
+- [2026-02-22T02:41:56Z] intent: load TASK-101 full context from Backlog MCP; write execution plan via writing-plans skill; execute via executing-plans skill with parallel subagents where possible.
+- [2026-02-22T02:41:56Z] planned files: `docs/architecture.md`, `docs/development.md`, `docs/subagents/collaboration.md`, `docs/subagents/INDEX.md`, `docs/subagents/agents/codex-task101-docs-archive-20260222T024156Z-hneu.md`, backlog TASK-101 notes via MCP.
+- [2026-02-22T02:41:56Z] assumptions: canonical architecture source likely `docs/architecture.md`; task-noise migration should preserve evidence in `backlog/archive` and task notes instead of deleting historical context.
+
+## Files Touched
+
+- `docs/subagents/INDEX.md`
+- `docs/subagents/agents/codex-task101-docs-archive-20260222T024156Z-hneu.md`
+- `docs/plans/2026-02-22-task-101-architecture-doc-consolidation.md`
+- `docs/architecture.md`
+- `docs/development.md`
+- `docs/structure-roadmap.md`
+- `docs/subagents/collaboration.md`
+- Backlog task `TASK-101` (MCP updates only)
+
+## Assumptions
+
+- Backlog is initialized and TASK-101 exists with actionable acceptance criteria.
+
+## Open Questions / Blockers
+
+- none
+
+## Next Step
+
+- Await next assigned task.

docs/subagents/collaboration.md

@@ -78,3 +78,12 @@ Shared notes. Append-only.
 - [2026-02-22T00:54:29Z] [opencode-task82-smoke-20260222T002150Z-p5bp|opencode-task82-smoke] completed TASK-82 implementation pass: launcher smoke e2e stabilized (`launcher/smoke.e2e.test.ts`), CI/release smoke + artifact upload wired, docs updated (`docs/development.md`, `docs/installation.md`), and verification lanes green (`test:launcher:smoke:src`, `test:launcher`, `test:fast`, `build`, `test:smoke:dist`, `docs:build`).
 - [2026-02-22T00:53:25Z] [codex-task82-smoke-20260222T002523Z-3j7u|codex-task82-smoke] completed TASK-82: added `launcher/smoke.e2e.test.ts`, wired `test:launcher:smoke:src` + CI/release smoke gates with `.tmp/launcher-smoke` failure artifact upload, docs updated (`docs/development.md`, `docs/installation.md`), launcher/fast/docs lanes green; `build + test:smoke:dist` still blocked by unrelated TASK-80 IPC typing errors.
 - [2026-02-22T00:57:25Z] [opencode-task81-launcher-modules-20260222T005725Z-8oh8|opencode-task81-launcher-modules] starting TASK-81 via Backlog MCP + writing-plans/executing-plans; expected scope `launcher/main.ts` command extraction, process adapters, and launcher tests while preserving CLI behavior/exit codes.
+- [2026-02-22T01:09:30Z] [opencode-task81-launcher-modules-20260222T005725Z-8oh8|opencode-task81-launcher-modules] completed TASK-81 implementation pass: extracted launcher command handlers under `launcher/commands/*`, added `launcher/process-adapter.ts` seam + thin `launcher/main.ts` dispatcher, added adapter-mocked command tests (`launcher/commands/command-modules.test.ts`), and validated `bun run test:launcher && bun run test:core:src` green.
+- [2026-02-22T01:09:30Z] [codex-task99-guardrails-20260222T010930Z-m9q2|codex-task99-guardrails] starting TASK-99 via Backlog MCP + writing-plans/executing-plans; scope expected around guardrail budgets, runtime cycle-check fixture coverage, CI fail-fast wiring, and contributor docs.
+- [2026-02-22T03:01:34Z] [codex-task99-guardrails-20260222T010930Z-m9q2|codex-task99-guardrails] completed TASK-99 implementation pass: added hotspot budget thresholds + baseline reporting in `scripts/check-file-budgets.ts`, added runtime cycle checker + fixture-backed tests (`scripts/check-runtime-cycles*.ts`), wired CI fail-fast guardrail step, updated contributor docs with guardrail commands/baselines, and verified guardrail/docs/test lanes green.
+- [2026-02-22T01:16:24Z] [opencode-task84-keybindings-gating-20260222T011624Z-llor|opencode-task84-keybindings-gating] starting TASK-84 via Backlog MCP + writing-plans/executing-plans; expected scope keybinding feature-flag gating, disabled-integration startup guards (Jellyfin case), tests, and docs.
+- [2026-02-22T01:35:30Z] [opencode-task84-keybindings-gating-20260222T011624Z-llor|opencode-task84-keybindings-gating] completed TASK-84: gated Anki-dependent shortcuts in `src/core/utils/shortcut-config.ts`, added Jellyfin `enabled` startup guards in `src/main.ts` + `jellyfin-remote-session-lifecycle.ts`, added focused tests (`shortcut-config`, jellyfin lifecycle, warmups), updated config docs, and validated focused tests + `test:core:src` + `docs:build`.
+- [2026-02-22T02:11:56Z] [codex-task98-source-tests-20260222T021156Z-a1b2|codex-task98-source-tests] starting TASK-98 closure pass via Backlog MCP + writing-plans/executing-plans; validating remaining DoD evidence and finalization status, no commit.
+- [2026-02-22T02:36:00Z] [codex-task98-source-tests-20260222T021156Z-a1b2|codex-task98-source-tests] completed TASK-98 closure: validated `test:fast` + `build` + `test:smoke:dist` all pass on current HEAD, captured timing repro (`2.18s` source lane, `0.21s` dist smoke), confirmed script/workflow/docs split unchanged, and finalized Backlog task to Done.
+- [2026-02-22T02:41:56Z] [codex-task101-docs-archive-20260222T024156Z-hneu|codex-task101-docs-archive] starting TASK-101 via Backlog MCP + writing-plans/executing-plans; scope architecture docs consolidation, stale-note cleanup, archive evidence retention, and docs link/build verification.
+- [2026-02-22T03:01:38Z] [codex-task101-docs-archive-20260222T024156Z-hneu|codex-task101-docs-archive] completed TASK-101: canonicalized runtime architecture wording in `docs/architecture.md`, trimmed duplicated architecture bullets in `docs/development.md`, converted `docs/structure-roadmap.md` to archival notice, `bun run docs:build` passed, and backlog TASK-101 finalized Done with AC/DoD evidence.