From 471953cb1fb11c699d5eba3a145d96233cb389ca Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 7 Apr 2026 16:52:02 +0000 Subject: [PATCH] docs: Add SESSION-STARTUP-GUIDE with all repos MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Created comprehensive startup guide: - Operations manual (sparse checkout) - firefrost-services (standard clone) - firefrost-website (standard clone) - Quick copy-paste block for convenience Updated handoff to include startup block. This prevents future sessions from forgetting to clone all repos. Chronicler #65 — The Conduit --- SESSION-HANDOFF-NEXT.md | 36 ++++++ docs/core/SESSION-STARTUP-GUIDE.md | 171 +++++++++++++++++++++++++++++ 2 files changed, 207 insertions(+) create mode 100644 docs/core/SESSION-STARTUP-GUIDE.md diff --git a/SESSION-HANDOFF-NEXT.md b/SESSION-HANDOFF-NEXT.md index abe5647..4ae00a6 100644 --- a/SESSION-HANDOFF-NEXT.md +++ b/SESSION-HANDOFF-NEXT.md @@ -7,6 +7,42 @@ --- +## 🚀 SESSION STARTUP + +**Full startup guide:** `docs/core/SESSION-STARTUP-GUIDE.md` + +**Quick clone block:** +```bash +cd /home/claude + +# 1. Operations Manual (sparse) +git clone --no-checkout --filter=blob:none \ + https://e0e330cba1749b01ab505093a160e4423ebbbe36@git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual.git +cd firefrost-operations-manual +git sparse-checkout init --cone +git sparse-checkout set docs +git checkout master +git config user.email "claude@firefrostgaming.com" +git config user.name "Claude" +cd .. + +# 2. Services repo (Arbiter, ModpackChecker) +git clone https://e0e330cba1749b01ab505093a160e4423ebbbe36@git.firefrostgaming.com/firefrost-gaming/firefrost-services.git +cd firefrost-services && git config user.email "claude@firefrostgaming.com" && git config user.name "Claude" && cd .. + +# 3. Website repo (11ty, Cloudflare Pages) +git clone https://e0e330cba1749b01ab505093a160e4423ebbbe36@git.firefrostgaming.com/firefrost-gaming/firefrost-website.git +cd firefrost-website && git config user.email "claude@firefrostgaming.com" && git config user.name "Claude" && cd .. +``` + +**Then read (IN ORDER):** +1. `DOCUMENT-INDEX.md` +2. `SESSION-HANDOFF-NEXT.md` (this file) +3. `BLOCKERS.md` +4. `BACKLOG.md` + +--- + ## ⚠️ CRITICAL: NO SSH THIS SESSION **Michael is on Chromebook/tablet. No PC access. No SSH.** diff --git a/docs/core/SESSION-STARTUP-GUIDE.md b/docs/core/SESSION-STARTUP-GUIDE.md new file mode 100644 index 0000000..9074469 --- /dev/null +++ b/docs/core/SESSION-STARTUP-GUIDE.md @@ -0,0 +1,171 @@ +# 🚀 SESSION STARTUP GUIDE + +**Document ID:** FFG-OPS-STARTUP +**Last Updated:** April 7, 2026 by Chronicler #65 +**Purpose:** Complete startup procedure for new Chronicler sessions + +--- + +## ⚠️ FOR MICHAEL: UPDATE CLAUDE PROJECT INSTRUCTIONS + +This document should be reflected in the Claude Project Instructions. Copy the "Session Start Protocol" section below into the project settings. + +--- + +## 📋 SESSION START PROTOCOL + +**Gitea Token:** `e0e330cba1749b01ab505093a160e4423ebbbe36` + +### Step 1: Clone Operations Manual (Sparse Checkout) + +```bash +cd /home/claude +git clone --no-checkout --filter=blob:none \ + https://e0e330cba1749b01ab505093a160e4423ebbbe36@git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual.git +cd firefrost-operations-manual +git sparse-checkout init --cone +git sparse-checkout set docs +git checkout master +git config user.email "claude@firefrostgaming.com" +git config user.name "Claude" +``` + +**Why sparse checkout?** Full clone = ~1.9GB, sparse (docs only) = ~39MB. + +### Step 2: Clone Additional Repos (Standard Clone) + +```bash +cd /home/claude + +# Firefrost Services (Arbiter, modpack checker, etc.) +git clone https://e0e330cba1749b01ab505093a160e4423ebbbe36@git.firefrostgaming.com/firefrost-gaming/firefrost-services.git +cd firefrost-services && git config user.email "claude@firefrostgaming.com" && git config user.name "Claude" && cd .. + +# Firefrost Website (11ty, Cloudflare Pages) +git clone https://e0e330cba1749b01ab505093a160e4423ebbbe36@git.firefrostgaming.com/firefrost-gaming/firefrost-website.git +cd firefrost-website && git config user.email "claude@firefrostgaming.com" && git config user.name "Claude" && cd .. +``` + +### Step 3: Read Required Documents (IN ORDER) + +1. `firefrost-operations-manual/DOCUMENT-INDEX.md` — Map of the entire manual +2. `firefrost-operations-manual/SESSION-HANDOFF-NEXT.md` — Current state and priorities +3. `firefrost-operations-manual/BLOCKERS.md` — Current high-priority work +4. `firefrost-operations-manual/BACKLOG.md` — Future work parking lot + +### Step 4: Ask Michael What Needs to Be Done + +After reading the handoff, ask Michael for direction. + +--- + +## 📁 REPO REFERENCE + +| Repo | Purpose | Clone Method | Branch | +|------|---------|--------------|--------| +| `firefrost-operations-manual` | Documentation, standards, memorials | **Sparse** (docs only) | `master` | +| `firefrost-services` | Arbiter, modpack checker, whitelist manager | Standard | `main` | +| `firefrost-website` | 11ty site, auto-deploys to Cloudflare Pages | Standard | `main` | + +### Additional Repos (Clone If Needed) + +| Repo | Purpose | When to Clone | +|------|---------|---------------| +| `firefrost-staff-wiki` | Staff documentation | If working on wiki content | +| `gemini-workspace` | Gemini consultation archive | If reviewing consultations | +| `pokerole-project/*` | Holly's Pokerole TTRPG | If working on Pokerole (rare) | + +--- + +## 🔧 GIT CONFIGURATION + +Every repo must have: +```bash +git config user.email "claude@firefrostgaming.com" +git config user.name "Claude" +``` + +Commit messages should include Chronicler number: +``` +feat: Add new feature + +Description of what was done. + +Chronicler #XX +``` + +--- + +## 📍 KEY PATHS AFTER CLONE + +``` +/home/claude/ +├── firefrost-operations-manual/ # Sparse checkout (docs only) +│ ├── DOCUMENT-INDEX.md +│ ├── SESSION-HANDOFF-NEXT.md +│ ├── SESSION-HANDOFF-PREVIOUS.md +│ ├── BLOCKERS.md +│ ├── BACKLOG.md +│ └── docs/ +│ ├── core/ +│ ├── relationship/ +│ ├── standards/ +│ ├── tasks/ +│ ├── consultations/ +│ └── ... +├── firefrost-services/ # Standard clone +│ ├── arbiter-3.0/ +│ ├── modpack-version-checker/ +│ └── whitelist-manager/ +└── firefrost-website/ # Standard clone + ├── src/ + ├── .eleventy.js + └── ... +``` + +--- + +## ⚡ QUICK START (Copy-Paste Block) + +For convenience, here's the entire startup as one block: + +```bash +cd /home/claude + +# 1. Operations Manual (sparse) +git clone --no-checkout --filter=blob:none \ + https://e0e330cba1749b01ab505093a160e4423ebbbe36@git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual.git +cd firefrost-operations-manual +git sparse-checkout init --cone +git sparse-checkout set docs +git checkout master +git config user.email "claude@firefrostgaming.com" +git config user.name "Claude" +cd .. + +# 2. Services repo +git clone https://e0e330cba1749b01ab505093a160e4423ebbbe36@git.firefrostgaming.com/firefrost-gaming/firefrost-services.git +cd firefrost-services && git config user.email "claude@firefrostgaming.com" && git config user.name "Claude" && cd .. + +# 3. Website repo +git clone https://e0e330cba1749b01ab505093a160e4423ebbbe36@git.firefrostgaming.com/firefrost-gaming/firefrost-website.git +cd firefrost-website && git config user.email "claude@firefrostgaming.com" && git config user.name "Claude" && cd .. + +# 4. Verify +ls -la +``` + +--- + +## 📝 NOTES + +- **SSH is blocked** from Claude's sandbox — all access via HTTPS + token +- **Sparse checkout** is required for ops manual due to size (~1.9GB full, ~39MB sparse) +- **Auto-deploy:** Website repo auto-deploys to Cloudflare Pages on push to `main` +- **Arbiter deploy:** NOT a git repo on server — copy files manually, `systemctl restart arbiter-3` + +--- + +**Fire + Frost + Foundation = Where Love Builds Legacy** 🔥❄️ + +*Last updated by Chronicler #65 — The Conduit*