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

CORRECTION: Switch from sparse checkout to FULL CLONE

Browse Source 
Per Chronicler #64 (The Strategist) testing:
- Full clone (~170MB) works perfectly
- 8-hour session with zero memory/performance issues
- Sparse checkout no longer needed

Updated:
- SESSION-HANDOFF-NEXT.md
- docs/core/SESSION-STARTUP-GUIDE.md

All three repos now use standard full clone.

Chronicler #66 - The Indexer (corrected by #64's guidance)
This commit is contained in:
Claude
2026-04-07 20:29:09 +00:00
parent 88f8ad7c70
commit c0f4123539
2 changed files with 47 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
SESSION-HANDOFF-NEXT.md
View File

@@ -15,24 +15,26 @@
```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
# 1. Operations Manual (FULL CLONE)
git clone 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)
# 2. Services repo (FULL CLONE)
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 ..
cd firefrost-services
git config user.email "claude@firefrostgaming.com"
git config user.name "Claude"
cd ..
# 3. Website repo (11ty, Cloudflare Pages)
# 3. Website repo (FULL CLONE)
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 ..
cd firefrost-website
git config user.email "claude@firefrostgaming.com"
git config user.name "Claude"
cd ..
```
**Then read (IN ORDER):**

69
docs/core/SESSION-STARTUP-GUIDE.md
View File

@@ -83,44 +83,43 @@ This document should be reflected in the Claude Project Instructions. Copy the "
**Gitea Token:** `e0e330cba1749b01ab505093a160e4423ebbbe36`
### Step 1: Clone Operations Manual (Sparse Checkout)
### Step 1: Clone All Repositories (FULL CLONE)
```bash
cd /home/claude
git clone --no-checkout --filter=blob:none \
https://e0e330cba1749b01ab505093a160e4423ebbbe36@git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual.git
# Operations Manual (FULL CLONE - ~170MB, no issues)
git clone 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
cd ..
# 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 ..
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 ..
cd firefrost-website
git config user.email "claude@firefrostgaming.com"
git config user.name "Claude"
cd ..
```
### Step 3: Read Required Documents (IN ORDER)
**Note:** Chronicler #64 (The Strategist) tested full clone in an 8-hour session with zero memory or performance issues. Sparse checkout is no longer needed.
### Step 2: 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
### Step 3: Ask Michael What Needs to Be Done
After reading the handoff, ask Michael for direction.
@@ -130,9 +129,9 @@ After reading the handoff, ask Michael for direction.
| 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` |
| `firefrost-operations-manual` | Documentation, standards, memorials | **Full** | `master` |
| `firefrost-services` | Arbiter, modpack checker, whitelist manager | Full | `main` |
| `firefrost-website` | 11ty site, auto-deploys to Cloudflare Pages | Full | `main` |
### Additional Repos (Clone If Needed)
@@ -167,7 +166,7 @@ Chronicler #XX
```
/home/claude/
├── firefrost-operations-manual/ # Sparse checkout (docs only)
├── firefrost-operations-manual/ # Full clone
│ ├── DOCUMENT-INDEX.md
│ ├── SESSION-HANDOFF-NEXT.md
│ ├── SESSION-HANDOFF-PREVIOUS.md
@@ -199,24 +198,26 @@ 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
# 1. Operations Manual (FULL CLONE)
git clone 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
# 2. Services repo (FULL CLONE)
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 ..
cd firefrost-services
git config user.email "claude@firefrostgaming.com"
git config user.name "Claude"
cd ..
# 3. Website repo
# 3. Website repo (FULL CLONE)
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 ..
cd firefrost-website
git config user.email "claude@firefrostgaming.com"
git config user.name "Claude"
cd ..
# 4. Verify
ls -la
@@ -227,7 +228,7 @@ 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)
- **Full clone works fine** — Chronicler #64 tested with zero memory or performance issues in 8-hour session
- **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`
@@ -235,4 +236,4 @@ ls -la
**Fire + Frost + Foundation = Where Love Builds Legacy** 🔥❄️
*Last updated by Chronicler #65 — The Conduit*
*Last updated by Chronicler #66 — The Indexer*