firefrost-gaming/firefrost-operations-manual
3
0
Fork 0
Code Issues 146 Pull Requests Packages Projects Releases Wiki Activity

docs: Add SESSION-STARTUP-GUIDE with all repos

Browse Source 
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
This commit is contained in:
Claude
2026-04-07 16:52:02 +00:00
parent 867daa09c5
commit 471953cb1f
2 changed files with 207 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
SESSION-HANDOFF-NEXT.md
View File

@@ -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.**

171
docs/core/SESSION-STARTUP-GUIDE.md Normal file
View File

@@ -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*