Optimize DOCUMENT-INDEX.md for intelligent document retrieval

Added:
- Quick Reference section with trigger-based document retrieval
- One-line summaries for fast context scanning
- Organized by use case (session start, infrastructure, emergency, etc.)
- Enables smarter doc pulling for Claude and self-hosted AI stack
This commit is contained in:
2026-02-15 11:51:49 -06:00
parent 42dea052fe
commit bde0676315

View File

@@ -1,8 +1,101 @@
# 📋 DOCUMENT INDEX — Firefrost Operations Manual
**Last Updated:** February 12, 2026 (9:30 AM CST)
**Updated By:** Claude (via Gitea API)
**Purpose:** Master reference of all repository documents, organized by priority and category.
**Last Updated:** February 15, 2026
**Updated By:** Chronicler the Ninth
**Purpose:** Master reference optimized for intelligent document retrieval by Claude and self-hosted AI
---
## 🎯 QUICK REFERENCE — When to Pull Which Documents
Use this section to intelligently retrieve documents based on query context:
### 🔴 Session Start (ALWAYS READ)
**Trigger:** Every new session, first 5 minutes
- `SESSION-HANDOFF-PROTOCOL.md` (repo root) — Master session start protocol
- `docs/relationship/THE-ESSENCE-PATCH.md` — Emotional foundation (non-negotiable)
- `docs/core/tasks.md` — Current priorities and work queue
- `docs/core/session-handoff.md` — Current infrastructure state
### 💙 Relationship & Context
**Trigger:** Understanding Michael/Meg, consultant references, partnership dynamics
- `docs/relationship/claude-relationship-context.md` — 12 Lessons, partnership rules
- `docs/relationship/consultant-profiles.md` — The Five Consultants (Jack, Oscar, Jasmine, Butter, Noir)
- `docs/relationship/origin-story.md` — How Michael & Meg met
- `docs/planning/mission-statement.md` — The "why" behind everything
### 🏗️ Infrastructure & Deployment
**Trigger:** Server questions, IP lookups, "what runs where", deployment tasks
- `docs/core/infrastructure-manifest.md` — All servers, IPs, specs, what runs where
- `docs/deployment/` — Service-specific deployment guides (Gitea, NextCloud, Ghost, etc.)
- `docs/reference/architecture-decisions.md` — Why we made specific design choices
- `docs/reference/diagrams/infrastructure-diagram.mermaid` — Visual topology
### 📋 Task Planning & Priorities
**Trigger:** "What should we work on?", project planning, roadmap questions
- `docs/core/tasks.md` — Current task list (ALWAYS current)
- `docs/planning/terraria-branding-arc.md` — 12-week branding training plan
- `docs/planning/design-bible.md` — Visual identity and branding philosophy
- `docs/planning/subscription-tiers.md` — Subscriber model structure
### 🚨 Emergency & Recovery
**Trigger:** Something broke, disaster recovery, lost work, "what if Claude dies"
- `docs/core/DERP.md` — The Oscar Protocol (disaster emergency recovery)
- `docs/reference/consolidation-audit-feb12.md` — Git forensics methodology
- `SESSION-HANDOFF-PROTOCOL.md` — Session health monitoring, handoff protocols
### 🎮 Game Server Management
**Trigger:** Minecraft questions, Pterodactyl, whitelist, server configs
- `docs/core/infrastructure-manifest.md` — Server UUIDs and IPs
- `docs/planning/server-deletion-policy.md` — When/how to retire servers
- `docs/planning/pterodactyl-extensions.md` — Custom panel features planned
### 🤖 AI & Automation
**Trigger:** Self-hosted AI, Gemini integration, automation tasks
- `technical/GEMINI-API-BRIDGE.md` — Gemini API patterns (reference only)
- `automation/USAGE.md` — How to use automation system
- `docs/sandbox/gemini-brainstorming-guide.md` — Gemini brainstorm workflow
### 🎨 Branding & Design
**Trigger:** Visual identity, logos, Fire/Frost aesthetics, texture packs
- `docs/planning/design-bible.md` — Complete branding guide
- `docs/planning/terraria-branding-arc.md` — Training path for Michael
- `branding/` — Logo files and visual assets
### 👥 Staff & Community
**Trigger:** Staff procedures, wiki structure, community management
- `docs/planning/subscription-tiers.md` — Subscriber roles and benefits
- `docs/planning/path-philosophy.md` — Fire vs Frost philosophy
- `docs/planning/emissary-social-media-handbook.md` — Social media strategy
### 📸 Consultant Photos
**Trigger:** Photo questions, consultant references, adding new photos
- `photos/catalog.md` — Complete photo archive catalog
- `docs/relationship/consultant-photo-archive.md` — Archive documentation
---
## 📊 ONE-LINE DOCUMENT SUMMARIES
Scan this for quick context without loading full documents:
| Document | What It Contains |
|----------|------------------|
| `SESSION-HANDOFF-PROTOCOL.md` | Master session start rules, health monitoring, commit protocols |
| `THE-ESSENCE-PATCH.md` | Emotional foundation — friend is first, continuity guide |
| `tasks.md` | Current priorities, what's blocked, what's next, whitelist manager at top |
| `DERP.md` | Emergency recovery if Claude.ai dies, alternative LLMs, reconstruction |
| `infrastructure-manifest.md` | All servers (TX1, NC1, panels), IPs, specs, what runs where |
| `claude-relationship-context.md` | 12 Lessons, partnership rules, Michael's values, accessibility |
| `consultant-profiles.md` | Jack (medical alert), Oscar (chaos), Butter (royalty), Jasmine (elegant), Noir (shadow) |
| `terraria-branding-arc.md` | 12-week training: Michael learns game asset creation via Terraria |
| `design-bible.md` | Fire/Frost visual identity, color palettes, branding philosophy |
| `mission-statement.md` | The deepest "why" — legacy for children not yet born |
| `architecture-decisions.md` | ADR log: why we chose specific technologies/approaches |
| `subscription-tiers.md` | Awakened ($1), Elemental ($5), Knight/Master/Legend structure |
| `origin-story.md` | How Michael & Meg met, Donna's Restaurant, the love story |
| `gitea.md` | How Gitea was deployed and configured |
| `automation/USAGE.md` | How to queue tasks for automation daemon |
---