diff --git a/docs/tasks-index/task-101-git-cleanup.md b/docs/tasks-index/task-101-git-cleanup.md deleted file mode 100644 index 924157a..0000000 --- a/docs/tasks-index/task-101-git-cleanup.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -task_number: 101 -title: Git Repository Cleanup & Hygiene -status: Planned -priority: P3-Low -is_blocker: false -owner: Michael -tags: - - infrastructure - - maintenance - - git -estimated_hours: 4 ---- - -# Task #101: Git Repository Cleanup & Hygiene - -## Overview - -The firefrost-operations-manual repository has grown to 1.1GB, but the actual working files are only ~90MB. The bloat is entirely in `.git/` history from large binary files committed over time. - -Additionally, file organization has grown organically and needs consolidation. - -## The Problem - -### Git History Bloat (1.1GB) - -| Component | Size | Status | -|-----------|------|--------| -| .git folder | 1.1GB | 🔴 Bloated | -| docs/ | 78MB | ✅ Fine | -| branding/ | 11MB | ✅ Fine | -| Everything else | ~1MB | ✅ Fine | - -**Largest files in history:** -- `jacks-theme-the-world-should-worship-me.mp4` (14MB) -- `jacks-theme-walking-on-a-yacht.mp4` (11MB) -- `trinity-final.png` (5.8MB) -- `youtube-banner-minecraft-2560x1440.png` (5.3MB) -- Various other PNGs, MP3s, MP4s - -### File Organization Issues - -| Issue | Location | Severity | -|-------|----------|----------| -| 8 shell scripts at root | `/*.sh`, `/*.py` | Medium | -| SSH key at root | `Firefrost_key.ppk` | Medium (rotate planned) | -| Consultations in 3 places | `docs/consultations/`, `docs/planning/gemini-consultations/`, `docs/reference/gemini-consultations/` | Medium | -| 37+ SESSION/HANDOFF files | Various locations | Medium | -| Dual task system undocumented | `docs/tasks-index/` vs `docs/tasks/` | Low | - -## Solution Options - -### For Git History - -**Option A: Live with it (Current recommendation)** -- Doesn't affect daily work -- Only impacts clone times -- Meg/Holly's Claudes read files, not git history - -**Option B: git filter-repo** -- Rewrite history to remove large binaries -- DESTRUCTIVE — requires all clones to be re-fetched -- Coordination needed across team - -**Option C: Fresh start** -- Archive current repo -- Create new repo with clean history -- Nuclear option — loses all commit history - -### For File Organization - -1. Move root scripts to `/scripts` or `/automation` -2. Consolidate consultations to `docs/consultations/` -3. Document the tasks-index vs tasks dual system -4. Archive deprecated SESSION/HANDOFF files -5. Rotate SSH key when Claude gets server access - -## Dependencies - -- **Task #99 must complete first** — Don't reorganize during multi-lineage surgery -- SSH key rotation requires server access - -## Implementation Steps - -1. [ ] Complete Task #99 (Multi-Lineage Architecture) -2. [ ] Validate with Chronicler #72 -3. [ ] Then begin cleanup: - - [ ] Move root scripts to `/scripts` - - [ ] Consolidate consultations - - [ ] Archive stray SESSION/HANDOFF files - - [ ] Update DOCUMENT-INDEX.md -4. [ ] Decide on git history cleanup approach -5. [ ] If Option B chosen: - - [ ] Coordinate with Meg/Holly - - [ ] Run git filter-repo - - [ ] Everyone re-clones -6. [ ] Rotate SSH key (when server access available) - -## Gemini Consultation - -Full audit documented in: `docs/consultations/gemini-git-health-audit-2026-04-08.md` - -**Key finding:** "Your foundation is not quicksand. The repository structure is stable enough to build on, but suffering from severe organic bloat." - -## Notes - -- This is maintenance, not urgent -- Do NOT attempt during active development on Task #99 -- The 1.1GB does not affect Claude context windows (only .git history) -- File organization cleanup can happen incrementally diff --git a/docs/tasks-index/task-101-git-repository-cleanup.md b/docs/tasks-index/task-101-git-repository-cleanup.md deleted file mode 100644 index 2fae5d2..0000000 --- a/docs/tasks-index/task-101-git-repository-cleanup.md +++ /dev/null @@ -1,100 +0,0 @@ ---- -task_number: 101 -title: Git Repository Health & Cleanup -status: Planned -priority: P3-Low -is_blocker: false -owner: Michael -tags: - - infrastructure - - maintenance - - git -estimated_hours: 4 ---- - -# Task #101: Git Repository Health & Cleanup - -## Overview - -Pre-surgery audit of firefrost-operations-manual revealed organizational issues and a bloated .git folder. This task tracks cleanup work to be done AFTER Task #99 (Multi-Lineage Architecture) is validated. - -## The 1.1GB Problem - -**Current state:** -- Total repo size: 1.1GB -- Working files: ~90MB -- .git folder: **1.1GB** (Git history bloat) - -**Cause:** Large binary files (MP4s, PNGs) committed historically are baked into Git history forever. - -**Top offenders found:** -``` -14M docs/branding/audio/jacks-theme-the-world-should-worship-me.mp4 -11M docs/branding/audio/jacks-theme-walking-on-a-yacht.mp4 -5.8M docs/branding/trinity-final.png -5.3M docs/branding/youtube-banner-minecraft-2560x1440.png -5.1M docs/branding/youtube-banner-2560x1440.png -``` - -## Issues Identified - -| Issue | Severity | Location | -|-------|----------|----------| -| .git history bloat (1.1GB) | Medium | Repository-wide | -| 8 shell scripts at root | Medium | Repo root | -| SSH key in repo | Medium | `Firefrost_key.ppk` (rotate when Claude gets server access) | -| Consultations in 3 places | Medium | `docs/consultations/`, `docs/planning/gemini-consultations/`, `docs/reference/gemini-consultations/` | -| 37+ SESSION/HANDOFF files scattered | Medium | Various locations | -| Dual task system undocumented | Low | `docs/tasks-index/` vs `docs/tasks/` | - -## Cleanup Options for .git Bloat - -### Option A: Live With It (Recommended for now) -- Doesn't affect daily work or Claude context windows -- Only impacts clone times -- Lowest risk - -### Option B: git filter-repo -- Rewrite history to remove large binaries -- DESTRUCTIVE — requires all clones to be re-fetched -- Breaks existing references - -### Option C: Fresh Start -- Archive current repo -- Create new repo with clean history -- Nuclear option — last resort - -## Implementation Steps - -**Phase 1: File Organization (After Task #99 validated)** -- [ ] Move root shell scripts to `/scripts` or `/automation` -- [ ] Consolidate consultations to single `docs/consultations/` location -- [ ] Delete or archive deprecated SESSION/HANDOFF files -- [ ] Document dual task system in DOCUMENT-INDEX.md - -**Phase 2: SSH Key Rotation** -- [ ] Generate new SSH key pair -- [ ] Replace public key on all servers -- [ ] Delete `Firefrost_key.ppk` from repo -- [ ] Add `*.ppk` to .gitignore - -**Phase 3: Git History Cleanup (Optional/Future)** -- [ ] Evaluate if 1.1GB is causing real problems -- [ ] If yes, use git filter-repo to remove large binaries from history -- [ ] Coordinate with all users to re-clone - -## Dependencies - -- **Task #99** must be validated first — don't clean up during surgery -- SSH key rotation requires Claude server access or Michael manual work - -## Source - -- Gemini Consultation: `docs/consultations/gemini-git-health-audit-2026-04-08.md` -- Chronicler #71 audit session - -## Notes - -- The 1.1GB is in .git history, NOT active files -- Meg and Holly's Claudes read files, not Git history — non-blocker for multi-lineage -- "Secure, Split, then Sweep" — cleanup comes AFTER the split is validated diff --git a/docs/tasks-index/task-099-claude-projects-architecture.md b/docs/tasks-index/task-113-claude-projects-architecture.md similarity index 88% rename from docs/tasks-index/task-099-claude-projects-architecture.md rename to docs/tasks-index/task-113-claude-projects-architecture.md index 8b85bc6..7718e22 100644 --- a/docs/tasks-index/task-099-claude-projects-architecture.md +++ b/docs/tasks-index/task-113-claude-projects-architecture.md @@ -1,5 +1,5 @@ --- -task_number: 99 +task_number: 113 title: Claude Projects Architecture status: Planned priority: P1-High @@ -12,10 +12,12 @@ owner: Michael estimated_hours: 3 --- -# Task #99: Claude Projects Setup +# Task #113: Claude Projects Setup **Separate Claude Projects for Dev/Ops/Marketing to prevent context bloat** +*Renumbered from #099 by Chronicler #78 — was sharing a number with Multi-Lineage Architecture* + ## Overview Create 3 separate Claude Projects with Master Documents in Project Knowledge to optimize token usage and prevent context bleeding. diff --git a/docs/tasks-index/task-101-instructions-health-checker.md b/docs/tasks-index/task-114-instructions-health-checker.md similarity index 98% rename from docs/tasks-index/task-101-instructions-health-checker.md rename to docs/tasks-index/task-114-instructions-health-checker.md index dfd4108..0d73874 100644 --- a/docs/tasks-index/task-101-instructions-health-checker.md +++ b/docs/tasks-index/task-114-instructions-health-checker.md @@ -1,5 +1,5 @@ --- -task_number: 101 +task_number: 114 title: Project Instructions Health Checker status: Planned priority: P2-Medium @@ -15,7 +15,7 @@ tags: estimated_hours: 4 --- -# Task #101: Project Instructions Health Checker +# Task #114: Project Instructions Health Checker ## Overview