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