From 2307c185f21392ef1c75db0d8278dea0e6ae0fc0 Mon Sep 17 00:00:00 2001 From: mkrause612 Date: Thu, 12 Feb 2026 01:02:50 -0600 Subject: [PATCH] Update DOCUMENT-INDEX.md: New directory structure with primer, all paths updated --- DOCUMENT-INDEX.md | 220 +++++++++++++++++++++++++++------------------- 1 file changed, 129 insertions(+), 91 deletions(-) diff --git a/DOCUMENT-INDEX.md b/DOCUMENT-INDEX.md index b9b5995..8dd6b77 100644 --- a/DOCUMENT-INDEX.md +++ b/DOCUMENT-INDEX.md @@ -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) ---