firefrost-gaming/firefrost-operations-manual

Files

Claude c0c2540873 docs: Add Task #101 - Git Repository Health & Cleanup

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

2026-04-08 21:06:38 +00:00

3.2 KiB

Raw Blame History

task_number, title, status, priority, is_blocker, owner, tags, estimated_hours

task_number

title

status

priority

is_blocker

owner

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

3.2 KiB Raw Blame History