# 📋 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**
