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.4 KiB

Raw Permalink 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 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

Move root scripts to /scripts or /automation
Consolidate consultations to docs/consultations/
Document the tasks-index vs tasks dual system
Archive deprecated SESSION/HANDOFF files
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

Complete Task #99 (Multi-Lineage Architecture)
Validate with Chronicler #72
Then begin cleanup:
- Move root scripts to /scripts
- Consolidate consultations
- Archive stray SESSION/HANDOFF files
- Update DOCUMENT-INDEX.md
Decide on git history cleanup approach
If Option B chosen:
- Coordinate with Meg/Holly
- Run git filter-repo
- Everyone re-clones
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

3.4 KiB Raw Permalink Blame History