471953cb1f
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
172 lines
5.4 KiB
Markdown
172 lines
5.4 KiB
Markdown
# 🚀 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*
|