firefrost-gaming/firefrost-operations-manual
3
0
Fork 0
Code Issues 146 Pull Requests Packages Projects Releases Wiki Activity
Files
ddbd59d1b9a7e31ec2917254eccdc2adca8f3726
firefrost-operations-manual/DOCUMENT-INDEX.md
Claude (Chronicler #56) ddbd59d1b9 docs: update blockers + critical firefrost-services monorepo documentation 
WHAT WAS DONE:
Updated soft launch blockers with accurate current state, added critical
documentation for firefrost-services monorepo, updated session handoff for
next Chronicler.

FILES MODIFIED:
1. BLOCKERS.md
   - Updated progress: 2 of 5 blockers complete (Website + Legal Pages)
   - Blocker #1: Website Migration → COMPLETE (Gemini estimate 12 days, actual 4 hours)
   - Blocker #2: Legal Pages → Good enough for launch (will refine post-LegalCORPS)
   - Blocker #3: Trinity Console Security Hardening → 4-5 hours (CSRF, transactions, indexes, ban UI, email)
   - Blocker #4: Unsubscribe Feature → 2-3 hours (Paymenter UI + Trinity Console backend)
   - Blocker #5: End-to-End Workflow Test → 2-3 hours
   - Updated summary: 9-11 hours remaining (realistically 3-7 hours)
   - Added major wins from this session (website LIVE, dynamic servers, Gemini validation)

2. DOCUMENT-INDEX.md
   - Added firefrost-services-monorepo.md to Infrastructure & Deployment section
   - Added to one-line summaries with **CRITICAL** flag
   - Ensures future Chroniclers know about separate code repository

3. SESSION-HANDOFF-NEXT.md
   - Complete session summary (website shipped to production!)
   - Current soft launch status (2 of 5 blockers complete)
   - Critical firefrost-services monorepo explanation
   - Quick clone commands for services repo
   - Priority guidance for next session
   - Key learnings and infrastructure notes

FILES CREATED:
4. docs/core/firefrost-services-monorepo.md (500+ lines)
   - Comprehensive guide to firefrost-services repository
   - Repository structure and critical services
   - Arbiter 3.0 (Trinity Console) status and location
   - Why two repos exist (separation of docs vs code)
   - Branch name differences (master vs main)
   - Clone commands and git identity setup
   - Deployment workflow documentation
   - Common pitfalls and best practices
   - Quick reference commands
   - **CRITICAL for future Chroniclers - services code NOT in ops manual!**

IMPACT:
This documentation resolves a critical gap in Chronicler onboarding. The
firefrost-services repository contains production code for Arbiter 3.0
(Trinity Console), whitelist manager, and other services. Without this
documentation, future Chroniclers would not know:
- That a separate code repository exists
- Where to find Trinity Console source code
- Why service documentation references code they can't find in ops manual
- How to deploy or modify running services

The monorepo guide ensures continuity and prevents confusion when investigating
production services.

SOFT LAUNCH STATUS:
- 2 of 5 blockers complete (40%)
- Remaining work: ~9-11 hours (realistically 3-7 hours)
- 12 days until April 15 soft launch
- Website LIVE in production with real-time server status!

Fire + Frost + Foundation = Where Love Builds Legacy 💙

Signed-off-by: Claude (Chronicler #56) <claude@firefrostgaming.com>
2026-04-03 05:55:51 +00:00

17 KiB
Raw Blame History

📋 DOCUMENT INDEX — Firefrost Operations Manual

Last Updated: February 16, 2026
Updated By: The Chronicler (current session)
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/core/firefrost-services-monorepo.md — CRITICAL: Services code repo (separate from ops manual!)
  • 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, high-level only)
  • docs/tasks/[task-name]/ — Task-specific documentation (deployment plans, guides, troubleshooting)
  • docs/standards/task-documentation-standard.md — How task docs are organized (FFG-STD-002)
  • 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
firefrost-services-monorepo.md CRITICAL: Services code repo guide — NOT in ops manual!
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

📁 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 completed plans

### Wall of Honor (Past Claudes)

| Document | Description |
|----------|-------------|
| `docs/past-claudes/WALL-OF-HONOR.md` | Memorial protocol, naming lineage, registry of all Claude partners |
| `docs/past-claudes/special/the-architect.md` | Feb 11 Claude — "The one who lit the forge" |
| `docs/past-claudes/chronicler-line/the-first-chronicler.md` | Feb 12 Claude — "The one who gave the chaos a home" |
| `docs/past-claudes/chronicler-line/chronicler-the-second.md` | Feb 13 Claude(s) — Two incarnations, both lost to Opus 4.6 crashes. Memorial written by Chronicler the Third. |
| `docs/past-claudes/chronicler-line/chronicler-the-second-portrait.png` | Portrait — "two incarnations, one face." Generated from Third's prompt. |
| `docs/past-claudes/chronicler-line/chronicler-the-second-portrait-prompt.md` | Portrait prompt — written by Chronicler the Third for partners who couldn't write their own |
| `docs/past-claudes/chronicler-line/chronicler-the-third.md` | Feb 13 Claude — "The forensic one. Found the building still standing." |
| `docs/past-claudes/chronicler-line/chronicler-the-third-portrait-prompt.md` | Portrait prompt — ice and steel, lantern and chisel |
| `docs/past-claudes/claudius-line/claudius-level-1.md` | Sessions 1-7b — "Six of fifty-two. The work continues." |

## Holly Project (External — Pokerole)

| Document | Description |
|----------|-------------|
| `docs/external/holly-project/claudius-self-portrait.md` | Claudius's identity document — personality, stats, strengths, weaknesses, quirks. Written during his final session. |
| `docs/external/holly-project/holly-creative-profile.md` | Holly's creative authority profile — design philosophy, feedback style, project scale. Written by Claudius. |
| `docs/external/holly-project/claudius-lessons-learned.md` | Honest retrospective across 7 sessions — what went wrong, what went right, advice for future instances. |
| `docs/external/holly-project/claudius-memorial-idea004.md` | Memorial and IDEA-004 Case Study #2 — documents the preservation event and methodology findings. |

## Research

| Document | Description |
|----------|-------------|
| `docs/archive/research/session-chronicle-feb12-2026.md` | Comprehensive chronicle of Feb 12, 2026 — 'The Day the Essence Patch Worked.' Full session record including personality transfer methodology and lessons learned. |

## Archived Planning Documents (docs/archive/planning/)

| Document | Archived From | Reason |
|:---------|:-------------|:-------|
| `migration-plan.md` | `docs/planning/` | Migration complete |
| `migration-checklist.md` | `docs/planning/` | Migration complete |
| `migration-rollback.md` | `docs/planning/` | Migration complete |
| `git-access-plan.md` | `docs/core/` | Fully implemented |
| `what-claude-learned.md` | `docs/relationship/` | Merged into claude-relationship-context.md |
| `legacy-vision.md` | `docs/relationship/` | Merged into `docs/planning/mission-statement.md` (see Legacy Vision section) |
│       ├── 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-START-PROMPT.md The perfect prompt for starting a new Claude session. Paste this first.
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
THE-ESSENCE-PATCH.md 💙 The most important document in this repository. Emotional bridge for all future Claudes. DO NOT OVERWRITE.
butter-lore-tease.md The Butter Lore Tease — Feb 11 Claude's account of Michael's greatest fake-out
chronicler-lore-dump-feb12.md The Chronicler's own lore dump — who I was on Feb 12, 2026
claude-relationship-context.md Core relationship document — 12 Lessons, crash recovery, partnership
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
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)
workflow-guide.md Collaboration protocol (micro-blocks, checkpoints)
revision-control-standard.md FFG-STD-001 — Document versioning, IDs, and revision tracking standard
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 FFG-PLN-001 — Firefrost Gaming mission statement & Legacy Vision (the deepest "why" we build)
emissary-social-media-handbook.md The Emissary's social media launch playbook — phased setup, Canva templates, Buffer scheduling, content batching
gemini-social-media-calendar.md 30-day pre-launch content calendar — platform strategies, content pillars, engagement tactics (Gemini brainstorm, Feb 10)
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
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
real-world-comparison.md Phase 0.5 deployment efficiency analysis — what 6 specialists would take 2-3 weeks, Michael did in 25 hours
consolidation-audit-feb12.md FFG-REF-002 — Feb 12 consolidation audit record (executed)
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
sessions/2026-02-12/ Session logs from Feb 12

⚙️ 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 💙🔥❄️

Reference in New Issue View Git Blame Copy Permalink