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