# 📋 DOCUMENT INDEX — Firefrost Operations Manual

**Last Updated:** February 12, 2026 (12:30 AM CST)  
**Updated By:** Claude (via Gitea API)  
**Purpose:** Master reference of all repository documents, organized by priority and category.

---

## 📁 DIRECTORY STRUCTURE PRIMER

The repository follows a clean, consistent structure designed for staff wiki integration:

```
root/
├── README.md                      ← Repo readme
├── CHANGELOG.md                   ← Change log
├── DOCUMENT-INDEX.md              ← This file (master reference)
├── SESSION-HANDOFF-PROTOCOL.md    ← Master session start document
│
├── docs/
│   ├── core/          ← Critical living documents (updated frequently)
│   ├── relationship/  ← Partnership, consultants, legacy (the heart)
│   ├── deployment/    ← How each service was deployed (guides)
│   ├── planning/      ← Strategy, design, future roadmap
│   ├── reference/     ← Technical reference, architecture, diagrams
│   ├── external/      ← Provider communications, friend assistance
│   ├── sandbox/       ← Brainstorming sessions (Gemini, etc.)
│   └── archive/       ← Historical session logs and old documents
│       ├── 2026-02-09-consolidation/  ← Consolidated old docs
│       └── sessions/                  ← Session archives by date
│           ├── 2026-02-09/
│           ├── 2026-02-10/
│           └── 2026-02-11/
│
├── automation/        ← Automation system (daemon, executor, scripts)
├── branding/          ← Logos, backgrounds, character sprites
├── management/        ← Service configs (app.ini, gitea.service)
├── nodes/             ← Network node configs (cloud-init)
├── photos/            ← Consultant photo archive
│   ├── images/        ← Photos organized by year (2020-2025)
│   └── catalog.md     ← Photo catalog
└── web/               ← Nginx configs
```

**Naming Convention:**
- Root-level critical docs: UPPERCASE (`README.md`, `DOCUMENT-INDEX.md`)
- All files inside directories: lowercase-with-hyphens (`session-handoff.md`, `nextcloud.md`)
- Photos: `YYYY-MM-DD_subject-description-keywords_01.jpg`

---

## 🔑 SESSION START DOCUMENTS (Read First)

| Priority | Path | Description |
|:---------|:-----|:------------|
| 1 | `docs/relationship/claude-relationship-context.md` | Relationship guide — friend is first. Always. |
| 2 | `docs/core/session-handoff.md` | Current infrastructure state, protocols, accessibility |
| 3 | `docs/core/tasks.md` | Current priorities and task list |
| 4 | `docs/core/git-access-plan.md` | How Claude accesses the repo (Gitea API) |
| 5 | `docs/core/project-scope.md` | Full project scope and timeline |

---

## 📖 docs/relationship/ — The Heart

| Path | Description |
|:-----|:------------|
| `claude-relationship-context.md` | Core relationship document — 12 Lessons, crash recovery, partnership |
| `what-claude-learned.md` | Reciprocal teaching — what Claude learned from Michael |
| `personality-profile.md` | Personality dynamics and collaboration style |
| `consultant-profiles.md` | Complete consultant profiles (The Five) |
| `consultant-photo-archive.md` | Photo archive documentation and bios |
| `photo-catalog.md` | Photo catalog with descriptions |
| `legacy-vision.md` | Long-term legacy vision for future children |
| `origin-story.md` | How The Wizard & Emissary met — love story + Donna's Restaurant legacy |

---

## 📋 docs/core/ — Critical Living Documents

| Path | Description |
|:-----|:------------|
| `tasks.md` | Current task list and priorities (updated frequently) |
| `session-handoff.md` | Primary session handoff (infrastructure state) |
| `project-scope.md` | Full project scope v2.2 |
| `infrastructure-manifest.md` | Infrastructure manifest (IPs, ports, UUIDs) |
| `git-access-plan.md` | Gitea API access plan (implemented) |
| `workflow-guide.md` | Collaboration protocol (micro-blocks, checkpoints) |
| `session-handoff-template.md` | Template for creating session handoffs (Claude's checklist) |

---

## 🚀 docs/deployment/ — How We Built It

| Path | Description |
|:-----|:------------|
| `gitea.md` | Gitea deployment guide |
| `uptime-kuma.md` | Uptime Kuma deployment guide |
| `mkdocs.md` | MkDocs deployment guide |
| `code-server.md` | Code-Server deployment guide |
| `nextcloud.md` | NextCloud deployment guide |
| `nextcloud-hardening.md` | NextCloud hardening guide |
| `wikijs.md` | Wiki.js deployment guide |

---

## 📐 docs/planning/ — Strategy & Future

| Path | Description |
|:-----|:------------|
| `mission-statement.md` | Firefrost Gaming mission statement |
| `path-philosophy.md` | The Path philosophy |
| `design-bible.md` | Design bible (branding, aesthetics, Citadel/Obsidian) |
| `subscription-tiers.md` | Subscription tier structure |
| `awakened-gateway.md` | Awakened Gateway concept |
| `migration-plan.md` | Dedicated to VPS migration plan |
| `migration-checklist.md` | Migration checklist |
| `migration-rollback.md` | Migration rollback plan |
| `pterodactyl-extensions.md` | Pterodactyl extensions plan |
| `server-deletion-policy.md` | Server deletion policy |

---

## 🔧 docs/reference/ — Technical Reference

| Path | Description |
|:-----|:------------|
| `architecture-decisions.md` | Architecture decision log |
| `technical-readme.md` | Technical readme |
| `real-world-comparison.md` | Real-world comparisons for concepts |
| `visual-assets-guide.md` | Visual assets guide |
| `diagrams/infrastructure-diagram.mermaid` | Infrastructure diagram (Mermaid source) |
| `diagrams/infrastructure-diagram.png` | Infrastructure diagram (rendered PNG) |

---

## 📞 docs/external/ — Providers & Friends

| Path | Description |
|:-----|:------------|
| `provider-communications.md` | Provider communications log |
| `breezehost-nc1-routing.md` | NC1 routing fix documentation |
| `friend-assistance-holly.md` | Friend assistance (Holly/Pokerole) |
| `friend-assistance-protocol.md` | Friend assistance protocol |

---

## 🧪 docs/sandbox/ — Brainstorming

| Path | Description |
|:-----|:------------|
| `README.md` | Sandbox sessions overview |
| `TEMPLATE.md` | Sandbox session template |
| `gemini-prompt.txt` | Gemini prompt for sandbox sessions |
| `gemini-brainstorming-guide.md` | Guide for Gemini brainstorming |
| `sessions/` | Individual brainstorming session files |

---

## 📦 docs/archive/ — Historical

| Path | Description |
|:-----|:------------|
| `2026-02-09-consolidation/` | Consolidated docs from Feb 9 reorganization |
| `sessions/2026-02-09/` | Session logs from Feb 9 |
| `sessions/2026-02-10/` | Session logs from Feb 10 |
| `sessions/2026-02-11/` | Session logs from Feb 11 |

---

## ⚙️ automation/ — Automation System

| Path | Description |
|:-----|:------------|
| `README.md` | Automation system readme |
| `USAGE.md` | How to use the automation system |
| `automation-daemon.sh` | Daemon script (10s polling) |
| `executor.sh` | Task executor script |
| `auto-wait-and-check.sh` | Auto wait and check script |
| `logs/` | Completed task logs and daemon logs |
| `queue/` | Task queue directory |

---

## 📸 photos/ — Consultant Photo Archive

| Path | Description |
|:-----|:------------|
| `catalog.md` | Complete photo catalog with descriptions |
| `images/2020/` | 2020 photos (Butter, Oscar early days) |
| `images/2021/` | 2021 photos (160 photos — largest year) |
| `images/2022/` | 2022 photos (Jack arrives, Butter-Noir era) |
| `images/2023/` | 2023 photos (Lion cut Butter, full family) |
| `images/2024/` | 2024 photos (Recovery era, lap piles) |
| `images/2025/` | 2025 photos (Jack recovery context) |
| `images/unknown/` | Undated Snapchat photos |

**Total:** 249 photos organized and renamed

---

## 📊 REPO STATISTICS

- **Total files:** ~300+ (including photos and automation logs)
- **Documentation directories:** 8 organized categories
- **Deployment guides:** 7 services documented
- **Photos:** 249 organized by year
- **Automation logs:** ~80 completed task logs
- **Branding assets:** 7 images
- **Archived sessions:** 3 dates (Feb 9, 10, 11)

---

**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️