Top-level doc count: 24 → 13. No plans or technical content removed —
this commit is pure consolidation and archival.
Merge (3 → 1):
SHELL-ARCHITECTURE.md (665 lines)
SHELL-MODULES.md (769 lines)
firstboot/MODULE-MANIFEST.md (628 lines)
→ FIRSTBOOT.md (710 lines)
The three deleted files described the same firstboot/ codebase from three
angles (philosophy, function reference, dependency graph). A reader trying
to understand a module had to cross-reference all three; FIRSTBOOT.md
unifies them as one doc with sections (philosophy, architecture, dependency
graph, per-module reference, error handling, testing, POSIX rules).
Archive (8 docs → .archive/completed-work/):
CLAWDIE-ISO.md (self-flagged DEPRECATED)
QT6-IMPLEMENTATION-PLAN.md (Qt6 installer direction abandoned)
PHASE4-SUMMARY.md (phase complete)
PHASE4-TESTING-INSTRUCTIONS.md (phase complete)
INSTALLER-PLAN.md (Apr 2026 plan, predates xfce-operator-usb)
doc/ISO-LIVE-GUI-SETUP-PROPOSAL.md (proposal; design now in code)
doc/NOMADBSD-XFCE-USB-POC.md (POC findings; SDDM+XFCE design now in code)
doc/OPERATOR-USB-XFCE-PROPOSAL.md (proposal → reality)
Link updates in active docs:
README.md two links replaced by FIRSTBOOT.md reference
TESTING.md two links replaced by FIRSTBOOT.md reference
doc/SESSION-STAB-HANDOFF.md CLAWDIE-ISO.md reference re-pathed to
.archive/completed-work/
Left intentionally untouched:
CHANGELOG.md historical v0.9.0 entry naming SHELL-MODULES.md —
release notes are version-frozen
RELEASE-NOTES-v0.9.0.md same reason
End state:
Top-level docs: 24 → 13
Visible KB: ~290 → ~170
Plans preserved: 100% (8 archived, 3 merged)
Build: pass — sh -n build.sh
Tests: pass — git diff --check
Sam & Claude
9dbfa70132