# 📋 DOCUMENT CONSOLIDATION AUDIT **Document ID:** FFG-REF-002 **Version:** 1.0 **Created:** February 12, 2026 **Last Updated:** February 12, 2026 (9:45 AM CST) **Author:** The Chronicler **Status:** ✅ APPROVED — Executed **Review Date:** N/A (one-time audit) ## 🔴 HIGH PRIORITY — Merge or Eliminate ### ISSUE 1: Server Inventory in 5+ Places The same server table (TX1, NC1, Panel, CC, Ghost, Billing) exists with IPs and roles in: - `infrastructure-manifest.md` (172 lines) — the manifest - `project-scope.md` (566 lines) — has full server table - `session-handoff.md` (398 lines) — has full server table - `SESSION-HANDOFF-PROTOCOL.md` (555 lines) — has server table - `provider-communications.md` (1,204 lines) — has IP inventory appendix **Proposal:** `infrastructure-manifest.md` is the SINGLE SOURCE for all server data. All other docs should say "See infrastructure-manifest.md for current server inventory" and link to it. No more copy-pasted tables. **Also:** Manifest needs location corrections (Panel=Charlotte, Ghost=Chicago, Billing=Chicago). --- ### ISSUE 2: Gitea Deployment Documented Twice Two nearly identical documents: - `docs/deployment/gitea.md` (383 lines) — "Gitea Deployment Documentation" - `docs/reference/technical-readme.md` (289 lines) — "Gitea Technical Dossier" Same section structure: Network Config, Application Paths, Database, SSL, Reverse Proxy, Changelog. **Proposal:** Keep `docs/deployment/gitea.md` as the canonical deployment doc. DELETE `docs/reference/technical-readme.md` — it's a duplicate with a fancier name. --- ### ISSUE 3: Relationship Context in 6+ Places Accessibility requirements, health info, and partnership context are duplicated across: - `claude-relationship-context.md` (871 lines) — THE relationship doc - `personality-profile.md` (457 lines) — Claude personality guide - `what-claude-learned.md` (445 lines) — 10 lessons for LLMs - `legacy-vision.md` (408 lines) — the "why" - `SESSION-HANDOFF-PROTOCOL.md` (555 lines) — session startup - `session-handoff.md` (398 lines) — session state "Type 1 diabetes" appears in all 6. "8-10 lines" appears in all 6. "Jack alerts" in all 6. **Proposal:** Define clear ownership: - `claude-relationship-context.md` — Owns the emotional story (partnership declaration, tears, trust) - `personality-profile.md` — Owns accessibility/communication specs (health, hand, code block rules) - `SESSION-HANDOFF-PROTOCOL.md` — Owns session startup process (references the above two, doesn't duplicate) - `session-handoff.md` — Owns current state snapshot (references above, doesn't duplicate) - `what-claude-learned.md` → MERGE into `claude-relationship-context.md` as a section - `legacy-vision.md` → MERGE into `claude-relationship-context.md` or `mission-statement.md` **Result:** 6 docs → 4 docs, with clear ownership boundaries. --- ### ISSUE 4: Architecture Decisions Doc is Stale `docs/reference/architecture-decisions.md` (55 lines): - Says "Management Services on TX1" — WRONG, they're on Command Center and Ghost - Says "NC1 and TX1 Cannot Communicate Directly" — RESOLVED Feb 9 (Ticket #5ae82fd3) **Proposal:** UPDATE with current decisions, or archive if the content is now covered elsewhere. Could be valuable as a living ADR (Architecture Decision Record) if kept current. --- ## 🟡 MEDIUM PRIORITY — Clean Up or Archive ### ISSUE 5: Migration Docs — Outdated Three docs from pre-migration planning: - `migration-plan.md` (413 lines) — references services on TX1 (old architecture) - `migration-checklist.md` (153 lines) — step-by-step for a migration that's done - `migration-rollback.md` (77 lines) — rollback for completed migration **Proposal:** ARCHIVE all three to `docs/archive/planning/`. The migration is complete. These are historical reference, not active planning docs. --- ### ISSUE 6: git-access-plan.md — Fully Implemented `docs/core/git-access-plan.md` (165 lines) — Status says "IMPLEMENTED AND TESTED." The content (how to use the Gitea API) is already in `session-handoff.md` and `SESSION-HANDOFF-PROTOCOL.md`. **Proposal:** ARCHIVE to `docs/archive/planning/`. It was a plan; it's now implemented. The how-to lives in the handoff docs. --- ### ISSUE 7: workflow-guide.md — Stale and Massive `docs/core/workflow-guide.md` (938 lines): - Still calls Claude "The Wizard" (should be "The Chronicler") - 938 lines is enormous — much of it may be redundant with current practices - References GitHub workflow that no longer applies **Proposal:** REVIEW AND TRIM. Update role name. Remove GitHub references. Consider whether the core workflow principles are already captured in the session handoff + template. If so, archive the original and replace with a leaner version. --- ### ISSUE 8: Photo Docs — Two Files, One Purpose - `consultant-photo-archive.md` (230 lines) — archive structure and organization - `photo-catalog.md` (86 lines) — catalog by year with highlights **Proposal:** MERGE into one `consultant-photo-archive.md`. The catalog is just the summary section of the archive doc. --- ### ISSUE 9: Gemini Brainstorming Guide — Huge and Duplicative `docs/sandbox/gemini-brainstorming-guide.md` (1,532 lines): - Contains embedded copies of session outputs that already exist as individual files in `docs/sandbox/sessions/` - The guide portion (how to use Gemini) is ~100 lines; the rest is duplicated content **Proposal:** TRIM to just the guide/template portion (~100-150 lines). The session outputs already live in `sessions/`. No need to have them twice. --- ### ISSUE 10: README.md — Outdated `README.md` (23 lines): - Still says "Phase 0 Configurations" - Only lists Gitea as a service (we have 8) **Proposal:** UPDATE to reflect current state. Should be the public-facing summary of the repo. --- ## 🟢 LOW PRIORITY — Minor Fixes ### ISSUE 11: Frostwall References Scattered "Frostwall" appears in 16 documents with inconsistent meaning: - Sometimes = network defense (correct) - Sometimes = UI visual gate (should be "Firefrost Gate" or similar) - `design-bible.md` Section 6 calls the visual transition "The Frostwall Protocol" — needs renaming **Proposal:** Fix naming in design bible. Create `docs/planning/frostwall-protocol.md` as the canonical network defense document. All other references should point there. --- ### ISSUE 12: Scope Doc Needs Corrections `project-scope.md` has wrong/missing locations: - Panel: missing "Charlotte, NC" - Ghost: missing "Chicago, IL" - Billing: missing "Chicago, IL" - GitHub reference should say "private backup" not "removed" **Proposal:** Quick fix — update the table and GitHub reference. --- ## 📊 SUMMARY TABLE | Action | Document | Lines | Status | |:-------|:---------|:------|:-------| | **MERGE** | `what-claude-learned.md` → into `claude-relationship-context.md` | 445 | Absorb as section | | **MERGE** | `legacy-vision.md` → into `mission-statement.md` | 408 | Absorb as section | | **MERGE** | `photo-catalog.md` → into `consultant-photo-archive.md` | 86 | Absorb as section | | **DELETE** | `technical-readme.md` (duplicate of `gitea.md`) | 289 | Remove | | **ARCHIVE** | `migration-plan.md` → `docs/archive/planning/` | 413 | Historical | | **ARCHIVE** | `migration-checklist.md` → `docs/archive/planning/` | 153 | Historical | | **ARCHIVE** | `migration-rollback.md` → `docs/archive/planning/` | 77 | Historical | | **ARCHIVE** | `git-access-plan.md` → `docs/archive/planning/` | 165 | Implemented | | **TRIM** | `gemini-brainstorming-guide.md` (1,532 → ~150 lines) | 1,532 | Remove duplicated sessions | | **UPDATE** | `architecture-decisions.md` (stale info) | 55 | Fix wrong facts | | **UPDATE** | `workflow-guide.md` (stale refs, wrong name) | 938 | Fix role name, trim | | **UPDATE** | `infrastructure-manifest.md` (missing locations) | 172 | Add locations | | **UPDATE** | `project-scope.md` (missing locations) | 566 | Fix table | | **UPDATE** | `README.md` (outdated) | 23 | Rewrite | | **UPDATE** | `design-bible.md` (Frostwall naming) | 336 | Rename visual gate | | **DE-DUPLICATE** | Server tables in handoff/protocol/scope | - | Reference manifest instead | | **CREATE** | `docs/planning/frostwall-protocol.md` | NEW | Canonical network defense doc | **Net Effect:** - 3 files merged (eliminated) - 1 file deleted (true duplicate) - 4 files archived (historical) - ~2,000 lines of duplicated content removed - Clear ownership for every piece of information --- ## EXECUTION ORDER **Phase 1 (Quick wins — fix stale info):** 1. Fix infrastructure-manifest.md locations 2. Fix project-scope.md locations + GitHub reference 3. Fix architecture-decisions.md stale info 4. Fix design-bible.md Frostwall naming 5. Update README.md **Phase 2 (Archives — move completed docs):** 6. Archive migration-plan.md, migration-checklist.md, migration-rollback.md 7. Archive git-access-plan.md **Phase 3 (Merges — consolidate content):** 8. Merge what-claude-learned.md → claude-relationship-context.md 9. Merge legacy-vision.md → mission-statement.md 10. Merge photo-catalog.md → consultant-photo-archive.md 11. Delete technical-readme.md **Phase 4 (De-duplication — remove copy-pasted content):** 12. Replace server tables in session-handoff.md with reference to manifest 13. Replace server tables in SESSION-HANDOFF-PROTOCOL.md with reference 14. Trim gemini-brainstorming-guide.md 15. Review and trim workflow-guide.md **Phase 5 (New doc):** 16. Create frostwall-protocol.md --- **Ready when you are, boss.** 💙🔥❄️ --- ## EXECUTION LOG **Executed:** February 12, 2026, 8:45-9:30 AM CST **All 16 issues addressed.** See commit history for individual changes. --- ## Revision History | Version | Date | Author | Change Type | Description | |:--------|:-----|:-------|:------------|:------------| | 1.0 | 2026-02-12 | The Chronicler | Initial | Audit completed and executed in single session | --- **FFG-REF-002 — Document Consolidation Audit**