docs/ Retirement Candidates — 2026-06-10
Date: 2026-06-10 UTC Author: software-architect Parent card: #2438 Status: AWAITING OPERATOR REVIEW — no files are moved or deleted until operator approves
Instructions for operator review
Mark each item as APPROVED, REJECTED, or AMENDED. Feature-developer will execute approved moves in a follow-on PR. Nothing in this file is a done state — it is a proposal only.
Category: DELETE
Files with no operational or historical value. Safe to remove.
| File | Rationale |
|---|---|
docs/.DS_Store |
macOS artifact; should be gitignored globally |
docs/claude_research_prompt.md |
Agent prompt fragment; no operational value; not referenced anywhere |
docs/business/memory/project_sentiment_roadmap_shape123.md |
Agent context dump misplaced in business/memory; the canonical version lives in .claude/projects/ memory system |
docs/SUMMARY.md |
Appears to be a gitbook navigation stub from early project days; content is not relevant to current docs |
Category: ARCHIVE (move to docs/archive/)
Files with historical value but not referenced in active work. Preserving them out of the main tree reduces noise.
| File | Rationale |
|---|---|
docs/DOCUMENTATION_GOVERNANCE.md |
References prompt.ai/ paths that do not exist; governance is now agent-model-driven; historical only |
docs/DEVELOPMENT_LOG.md |
References non-existent prompt.ai/development_log.md; superseded by commit history |
docs/CI_HEALTH_GATE_RUNBOOK.md |
Content migrated to docs/ops/runbooks/; this root copy is orphaned |
docs/OBSERVABILITY_BASELINE.md |
Point-in-time snapshot from early project; likely drifted; keep as historical |
docs/SLACK_INTEGRATION.md |
Slack integration notes; pre-dates current ops model; keep for reference |
docs/QA_E2E_WORKFLOW.md |
Early E2E workflow doc; superseded by docs/qa/ artifacts |
docs/API.md |
Stub superseded by docs/API_DOCUMENTATION.md; keep for historical reference |
docs/grooming/2026-04-22-backlog-pass.md |
Oldest backlog pass; low forward value; preserve as archive |
docs/sprint/dispatch-plan-2026-05-19-morning-wave-2.md |
Sprint dispatch plan from 2026-05-19; completed; archive |
docs/sprint-plans/sprint-2026-05-21-launch-window.md |
Launch window sprint plan; completed; archive |
docs/blr/internal-docs-hostname-2026-04-29.md |
Hostname decision from April; decision is made; archive |
docs/blr/2026-05-29-getraxx-copy-draft-cluster.md |
BLR draft cluster; decisions made; archive |
docs/blr/2026-05-29-llc-post-formation-card-audit.md |
Post-formation audit; completed; archive |
docs/blr/2026-05-29-product-comprehensive-review.md |
Comprehensive review from May; archive |
docs/blr/2026-05-31-alpaca-display-rights-memo.md |
Memo on display rights; decision made; archive |
docs/console/dev-downtime.md |
Single-event downtime note; archive |
docs/console/feature-qa.md |
Historical QA artifact; archive |
docs/demo/demo-frontend-only-2026-05-13.md |
Historical note about demo-frontend-only approach; archive |
docs/decisions/ (entire dir, 1 file) |
Single file; unclear content; review and archive or delete |
docs/morning-brief/2026-06-02.md |
Single morning brief; these should live in .claude/ memory system, not docs/ |
docs/groomer/2026-06-01-morning-pass.md |
Agent grooming pass; archive after 60 days (past threshold) |
docs/groomer/2026-04-22-backlog-pass.md |
DUPLICATE of docs/grooming/2026-04-22-backlog-pass.md; delete one, archive other |
docs/ops/wake-up-brief-2026-05-19.md |
Morning brief; archive |
docs/ops/wake-up-brief-2026-05-20.md |
Morning brief; archive |
docs/ops/wake-up-brief-2026-05-21.md |
Morning brief; archive |
docs/ops/wake-up-brief-2026-05-22.md |
Morning brief; archive |
docs/ops/wake-up-brief-2026-05-23.md |
Morning brief; archive |
Category: MERGE INTO X
Files whose content belongs in another canonical document.
| File | Merge into | Rationale |
|---|---|---|
docs/RELEASE_1.1.0.md |
docs/release_notes/v1.1.0.md |
Exact duplicate; delete the root copy after verifying identity |
docs/release_notes_v1.0.0.md |
docs/release_notes/v1.0.0.md |
Exact duplicate; delete the root copy |
docs/technical_indicators_research.md |
docs/data-science/ |
Research content misplaced at root; move to data-science/ |
docs/secrets/cf-token-taxonomy.md |
docs/ops/runbooks/cloudflare-tokens.md or docs/security/ |
Token taxonomy content; the ops/runbooks/ has cloudflare-tokens.md which may already cover this. Merge or cross-link before deleting docs/secrets/. |
docs/rbac/groups.yaml |
docs/architecture/rbac-v2/ |
RBAC groups config belongs with RBAC architecture docs |
docs/dev/chart-of-accounts.md |
docs/business/ or docs/business/finance/ |
Finance artifact misplaced in dev/ |
Category: CONSOLIDATE DIRECTORY
Directories that should be folded into a canonical location. Execute as a batch mv, not file-by-file.
| Source directory | Canonical destination | File count | Notes |
|---|---|---|---|
docs/business-legal/ |
docs/business/ |
~18 files | Precursor to business/; content is a subset. Operator confirm before move (attorney correspondence). |
docs/runbooks/ (6 files) |
docs/ops/runbooks/ |
6 | Satellite runbooks dir; files should be checked for overlap with ops/runbooks/ before merge |
docs/grooming/ (1 file) |
docs/ops/grooming/ |
1 | |
docs/groomer/ (2 files) |
docs/ops/grooming/ |
2 | After deduplication check |
docs/incidents/ |
docs/ops/incidents/ |
~15 | Verify no duplicates with ops/incidents/ |
docs/sprint/ + docs/sprint-plans/ + docs/sprints/ |
docs/ops/pm/ |
4 total | Sprint planning artifacts; archive-eligible most |
docs/ux/ |
docs/design/ |
~54 files | Keep subdirs intact; just move the parent |
docs/ux-mockups/ |
docs/design/ |
4 files (images only) | Images from PR #2692; keep in design/ux-mockups-pr-2692/ |
docs/dev/ (minus chart-of-accounts) |
docs/sdlc/ |
4 files | README, local-setup, testing, vendor-conventions belong in sdlc/ |
docs/testing/ |
docs/qa/ |
1 file | founders-gate-tests.md |
docs/pm/ |
docs/ops/pm/ |
1 file | |
docs/product/ |
docs/ops/pm/ |
2 files | |
docs/launch/ |
docs/ops/ |
1 file | Prelaunch punch list |
docs/console/ |
docs/ops/ |
2 files | dev-downtime and feature-qa; archive-eligible |
docs/security/runbooks/ (1 file) |
docs/ops/runbooks/ |
1 | shadow-analytics.md runbook |
docs/secrets/ |
docs/security/ |
1 file | After merge per MERGE row above |
docs/finance/ |
docs/business/finance/ |
(empty) | Remove empty dir |
docs/operations/ |
(remove) | 0 | Appears empty |
Category: ADR NUMBER COLLISION REPAIR
13 pairs of ADRs share the same number. The second file at each collision needs renumbering. This is NOT a deletion — it is a rename to a valid unique number.
These require a separate focused PR because every rename must be followed by a
grep across all docs/ and .claude/ files that reference the old ADR number.
| Current (duplicate) filename | Proposed new number | Notes |
|---|---|---|
0004-ios-stack-swiftui-native.md |
0115 | Console-stack is the original 0004 |
0017-referral-slug-entropy.md |
0116 | e2e-shadow is the original 0017 context |
0018-shadow-analytics-data-goals.md |
0117 | referral-attribution-cookie is original 0018 |
0020-rbac-groups-not-direct-roles.md |
0118 | branch-promotion is original 0020 |
0028-status-page-hosting.md |
0119 | prod-deploy-friction is original 0028 |
0029-status-surface-registry.md |
0120 | console-staging-retirement is original 0029 |
0050-trunk-based-sdlc-affirmed.md |
0121 | fidelity-api-surface is original 0050 |
0051-fidelity-auth-flow.md |
0122 | drift-prevention is original 0051 |
0052-new-surface-hosting-tiers.md |
0123 | broker-adapter is original 0052 |
0076-queue-phase1-cpp-billing-v1.md |
0124 | billing-v1-aggressive is original 0076 |
0085-vcpkg-version-pinning-policy.md |
0125 | flag-reconciler is original 0085 |
0088-webhook-idempotency-5xx-not-local-queue.md |
0126 | docs-site-tooling is original 0088 |
0096-per-pr-context-swap-agent-identity.md |
0127 | console-dashboard-v2 is original 0096 |
MUST-REDACT items
No MUST-REDACT items found. See inventory doc §6 for confirmation.
The operator email kris@moosequest.net appears in docs/security/web-surface-posture.md
only as a CF Access allowlist configuration example. This file is behind CF Access and
is not in the customer-docs build. No redaction needed at this time.
Execution order recommendation
When operator approves:
- DELETE items first (4 files — lowest risk, no references)
- ADR number collision repair (separate PR; grep pass required)
- MERGE INTO X items (verify content identity before removing source)
- CONSOLIDATE DIRECTORY passes (batch mv operations, update any internal links)
- ARCHIVE items (batch mv to
docs/archive/) - Create
docs/README.mdfront door - Create
docs/_drafts/and move personal-scratch items
Each step should be a discrete PR. Do not attempt all steps in one PR.