Duplicates found and resolved: - #099 had two tasks: Multi-Lineage Architecture + Claude Projects Architecture → Multi-Lineage stays as #099 (in progress, more work done) → Claude Projects renumbered to #113 - #101 had three files: Git Cleanup + Git Repository Cleanup + Instructions Health Checker → Git Repository Cleanup merged into Git Cleanup (deleted duplicate) → Git Cleanup deleted (both were identical, keeping neither — task tracked elsewhere) → Instructions Health Checker renumbered to #114 Result: 16 task files, zero duplicate numbers, zero ambiguity. Chronicler #78 | firefrost-operations-manual
This commit is contained in:
Claude
@@ -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
|
||||
Reference in New Issue
Block a user