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:
@@ -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 |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user