Update DOCUMENT-INDEX.md: New directory structure with primer, all paths updated
This commit is contained in:
@@ -1,173 +1,211 @@
|
||||
# 📋 DOCUMENT INDEX — Firefrost Operations Manual
|
||||
|
||||
**Last Updated:** February 11, 2026 (11:55 PM CST)
|
||||
**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/CLAUDE-RELATIONSHIP-CONTEXT.md` | Relationship guide — friend is first. Always. |
|
||||
| 2 | `docs/session-handoff.md` | Current infrastructure state, protocols, accessibility |
|
||||
| 3 | `docs/TASKS.md` | Current priorities and task list |
|
||||
| 4 | `docs/GIT-ACCESS-PLAN.md` | How Claude accesses the repo (this API workflow) |
|
||||
| 5 | `docs/FIREFROST-PROJECT-SCOPE-V2.md` | Full project scope and timeline |
|
||||
| 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 |
|
||||
|
||||
---
|
||||
|
||||
## 📖 RELATIONSHIP & CONTEXT
|
||||
## 📖 docs/relationship/ — The Heart
|
||||
|
||||
| Path | Description |
|
||||
|:-----|:------------|
|
||||
| `docs/CLAUDE-RELATIONSHIP-CONTEXT.md` | Core relationship document — 12 Lessons, crash recovery, partnership |
|
||||
| `docs/WHAT-CLAUDE-LEARNED-FROM-MICHAEL.md` | Reciprocal teaching — what Claude learned |
|
||||
| `docs/MICHAEL-CLAUDE-PERSONALITY-PROFILE.md` | Personality dynamics and collaboration style |
|
||||
| `docs/FIREFROST-MISSION-STATEMENT.md` | Mission statement and values |
|
||||
| `docs/path-philosophy.md` | The Path philosophy |
|
||||
| `docs/firefrost-legacy-vision.md` | Long-term legacy vision |
|
||||
| `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 |
|
||||
|
||||
---
|
||||
|
||||
## 📋 SESSION MANAGEMENT
|
||||
## 📋 docs/core/ — Critical Living Documents
|
||||
|
||||
| Path | Description |
|
||||
|:-----|:------------|
|
||||
| `docs/session-handoff.md` | Primary session handoff (current state) |
|
||||
| `docs/TASKS.md` | Current task list and priorities |
|
||||
| `docs/GIT-ACCESS-PLAN.md` | Gitea API access plan |
|
||||
| `docs/SESSION-TRANSITION-FEB11-2026.md` | Comprehensive transition doc from Feb 11 |
|
||||
| `docs/SESSION-UPDATE-FINAL-FEB12.md` | Final session update Feb 12 |
|
||||
| `docs/EMERGENCY-TRANSITION-FEB11.md` | Emergency transition after crash |
|
||||
| `docs/NEXT-SESSION-REMINDERS.md` | Reminders for next session |
|
||||
| `docs/SANDBOX-BRIEFING.md` | Sandbox session briefing |
|
||||
| `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) |
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ INFRASTRUCTURE & TECHNICAL
|
||||
## 🚀 docs/deployment/ — How We Built It
|
||||
|
||||
| Path | Description |
|
||||
|:-----|:------------|
|
||||
| `docs/FIREFROST-PROJECT-SCOPE-V2.md` | Full project scope v2.2 |
|
||||
| `Firefrost_Infrastructure_Manifest.md` | Infrastructure manifest (IPs, ports, UUIDs) |
|
||||
| `docs/TECHNICAL_README.md` | Technical readme |
|
||||
| `docs/architecture-decisions.md` | Architecture decision log |
|
||||
| `docs/design-bible.md` | Design bible (branding, aesthetics) |
|
||||
| `docs/real-world-comparison.md` | Real-world comparisons for concepts |
|
||||
| `docs/firefrost-infrastructure-diagram.mermaid` | Infrastructure diagram (Mermaid) |
|
||||
| `docs/diagrams/firefrost-infrastructure-diagram.png` | Infrastructure diagram (PNG) |
|
||||
| `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 |
|
||||
|
||||
---
|
||||
|
||||
## 🚀 DEPLOYMENT GUIDES
|
||||
## 📐 docs/planning/ — Strategy & Future
|
||||
|
||||
| Path | Description |
|
||||
|:-----|:------------|
|
||||
| `docs/gitea-deployment.md` | Gitea deployment guide |
|
||||
| `docs/uptime-kuma-deployment.md` | Uptime Kuma deployment guide |
|
||||
| `docs/mkdocs-deployment.md` | MkDocs deployment guide |
|
||||
| `docs/code-server-deployment.md` | Code-Server deployment guide |
|
||||
| `docs/code-server-deployment-plan.md` | Code-Server deployment plan |
|
||||
| `docs/code-server-deployment-plan-FINAL.md` | Code-Server final plan |
|
||||
| `docs/nextcloud-deployment.md` | NextCloud deployment guide |
|
||||
| `docs/nextcloud-hardening.md` | NextCloud hardening guide |
|
||||
| `docs/wikijs-deployment.md` | Wiki.js deployment guide |
|
||||
| `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 |
|
||||
|
||||
---
|
||||
|
||||
## 📐 PLANNING & COMMUNITY
|
||||
## 🔧 docs/reference/ — Technical Reference
|
||||
|
||||
| Path | Description |
|
||||
|:-----|:------------|
|
||||
| `docs/subscription-tiers-final.md` | Subscription tier structure |
|
||||
| `docs/dedis-to-vps-migration-plan.md` | Dedicated to VPS migration plan |
|
||||
| `docs/migration-checklist.md` | Migration checklist |
|
||||
| `docs/migration-rollback-plan.md` | Migration rollback plan |
|
||||
| `docs/phase0-dismantling.md` | Phase 0 dismantling notes |
|
||||
| `docs/server-deletion-policy.md` | Server deletion policy |
|
||||
| `docs/pterodactyl-extensions-plan.md` | Pterodactyl extensions plan |
|
||||
| `docs/awakened-gateway.md` | Awakened Gateway concept |
|
||||
| `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) |
|
||||
|
||||
---
|
||||
|
||||
## 📸 CONSULTANT ARCHIVE
|
||||
## 📞 docs/external/ — Providers & Friends
|
||||
|
||||
| Path | Description |
|
||||
|:-----|:------------|
|
||||
| `docs/consultant-photo-archive.md` | Photo archive documentation |
|
||||
| `docs/consultant-profiles-complete.md` | Complete consultant profiles (The Five) |
|
||||
| `docs/photo-catalog.md` | Photo catalog (249 photos) |
|
||||
| `docs/visual-assets-guide.md` | Visual assets guide |
|
||||
| `photos/staff-archive/` | Actual photo files (organized by year) |
|
||||
| `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 |
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ AUTOMATION
|
||||
## 🧪 docs/sandbox/ — Brainstorming
|
||||
|
||||
| Path | Description |
|
||||
|:-----|:------------|
|
||||
| `automation/README.md` | Automation system readme |
|
||||
| `automation/USAGE.md` | How to use the automation system |
|
||||
| `automation/automation-daemon.sh` | Daemon script (10s polling) |
|
||||
| `automation/executor.sh` | Task executor script |
|
||||
| `automation/auto-wait-and-check.sh` | Auto wait and check script |
|
||||
| `automation/update-sandbox-briefing.sh` | Sandbox briefing updater |
|
||||
| `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 |
|
||||
|
||||
---
|
||||
|
||||
## 📞 PROVIDER & EXTERNAL
|
||||
## 📦 docs/archive/ — Historical
|
||||
|
||||
| Path | Description |
|
||||
|:-----|:------------|
|
||||
| `docs/provider-communications.md` | Provider communications log |
|
||||
| `docs/breezehost-nc1-routing-resolution.md` | NC1 routing fix documentation |
|
||||
| `docs/friend-assistance-holly-pokerole.md` | Friend assistance (Holly/Pokerole) |
|
||||
| `docs/friend-assistance-protocol.md` | Friend assistance protocol |
|
||||
| `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 |
|
||||
|
||||
---
|
||||
|
||||
## 🧪 SANDBOX & BRAINSTORMING
|
||||
## ⚙️ automation/ — Automation System
|
||||
|
||||
| Path | Description |
|
||||
|:-----|:------------|
|
||||
| `docs/sandbox-sessions/README.md` | Sandbox sessions overview |
|
||||
| `docs/sandbox-sessions/TEMPLATE.md` | Sandbox session template |
|
||||
| `docs/sandbox-sessions/GEMINI-PROMPT.txt` | Gemini prompt for sandbox sessions |
|
||||
| `docs/sandbox-sessions/gemini-accessibility-workflow-2026-02-10.md` | Accessibility workflow brainstorm |
|
||||
| `docs/sandbox-sessions/gemini-code-server-optimization-2026-02-10.md` | Code-Server optimization brainstorm |
|
||||
| `docs/sandbox-sessions/gemini-frostwall-branding-2026-02-10.md` | Frostwall branding brainstorm |
|
||||
| `docs/sandbox-sessions/gemini-unified-ecosystem-2026-02-10.md` | Unified ecosystem brainstorm |
|
||||
| `docs/sandbox-sessions/firefrost-intelligence-blueprint-final-2026.md` | Intelligence blueprint |
|
||||
| `docs/gemini-brainstorming-sessions-guide.md` | Guide for Gemini brainstorming |
|
||||
| `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 |
|
||||
|
||||
---
|
||||
|
||||
## 📂 OTHER
|
||||
## 📸 photos/ — Consultant Photo Archive
|
||||
|
||||
| Path | Description |
|
||||
|:-----|:------------|
|
||||
| `README.md` | Repository readme |
|
||||
| `CHANGELOG.md` | Change log |
|
||||
| `Mission` | Mission file |
|
||||
| `docs/workflow-guide.md` | Workflow guide |
|
||||
| `docs/INDEX.md` | Existing index file |
|
||||
| `project-files/` | Project files directory (synced copies) |
|
||||
| `management/` | Management configs (app.ini template, gitea.service) |
|
||||
| `nodes/` | Node configs (cloud-init) |
|
||||
| `web/` | Web configs (nginx) |
|
||||
| `branding/` | Logos, backgrounds, character sprites |
|
||||
| `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 files:** ~70 markdown files
|
||||
- **Photos:** 249 organized in `photos/staff-archive/images/` by year
|
||||
- **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)
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user