213 lines
8.0 KiB
Markdown
213 lines
8.0 KiB
Markdown
# 📋 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 |
|
|
|
|
---
|
|
|
|
## 📋 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) |
|
|
|
|
---
|
|
|
|
## 🚀 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** 💙🔥❄️
|