# 🚀 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*