diff --git a/SESSION-HANDOFF-NEXT.md b/SESSION-HANDOFF-NEXT.md index 16b99b0..cf8e4e9 100644 --- a/SESSION-HANDOFF-NEXT.md +++ b/SESSION-HANDOFF-NEXT.md @@ -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):** diff --git a/docs/core/SESSION-STARTUP-GUIDE.md b/docs/core/SESSION-STARTUP-GUIDE.md index 3f79bdd..2c9786a 100644 --- a/docs/core/SESSION-STARTUP-GUIDE.md +++ b/docs/core/SESSION-STARTUP-GUIDE.md @@ -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*