Prior PR a6296ed7 claimed to consolidate 16 -> 7 canonical docs but
actually left 21 top-level files intact. Founder caught the theater.
This PR is the real consolidation. Top-level doc count: 21 -> 10.
Folded into keepers:
- AUDIT-PROCEDURE.md -> RUNBOOKS.md §9 (Doc-integrity audit cadence)
- CLUSTERMESH-CLUSTER-IDS.md -> ARCHITECTURE.md §15 (ClusterMesh ID assignment)
- FRANCHISE-MODEL.md -> BUSINESS-STRATEGY.md §17 (Franchise model)
- MULTI-REGION-DNS.md -> ARCHITECTURE.md §14 (Multi-region DNS topology)
- PLATFORM-POWERDNS.md -> ARCHITECTURE.md §13 (PowerDNS deployment shape)
- PRODUCT-FAMILIES.md -> BUSINESS-STRATEGY.md §18 (Product families map)
- SECRET-ROTATION.md -> SECURITY.md §11 (Secret rotation cadence)
- SOVEREIGN-PROVISIONING.md -> RUNBOOKS.md §8 (Bring up a Sovereign)
Moved to archive/ (oversized reference material, not load-bearing canon):
- COMPONENT-LOGOS.md -> archive/component-logos-asset-manifest.md
- PROVISIONING-PLAN.md -> archive/provisioning-plan-2026-04.md
- UI-REGRESSION-GUARDS.md -> archive/ui-regression-guards-catalog.md
Every folded section in a keeper carries a `> Source: previously docs/<X>.md`
attribution line so the audit trail survives. Every archived doc carries a
banner pointing back to the current keepers.
README.md Documentation table rewritten to reflect the new flat 10-top-level
+ 7-subdir structure. All cross-references in keeper docs that pointed at
folded orphans have been updated to point at the new section anchors.
Validation:
- `find docs -maxdepth 1 -type f -name '*.md' | wc -l` returns 10 (<= 10 target)
- Every README link target resolves (17/17 OK)
- Zero stale orphan references in current docs (only in sessions/ and adr/,
which are append-only historical and must not be mutated)
Closes#2098
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
8e96522d67