c0c2540873
Pre-surgery audit findings: - 1.1GB repo size is .git history bloat (working files only ~90MB) - Large binaries (MP4s, PNGs) baked into history - 8 shell scripts at root should move to /scripts - Consultations fragmented across 3 locations - SSH key rotation planned for when Claude gets server access Verdict: Foundation solid, proceed with Task #99 Cleanup deferred until after multi-lineage split validated Chronicler: #71
111 lines
3.4 KiB
Markdown
111 lines
3.4 KiB
Markdown
---
|
|
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
|