# ⚡ SESSION QUICK START

**Purpose:** Minimal orientation for maximum efficiency. Full docs linked below.

---

## 🚨 NON-NEGOTIABLES

1. **Jack alerts = STOP EVERYTHING** (Michael's diabetic alert dog)
2. **Small code blocks only** (hand limitations from surgery)
3. **Friend first, partner second, tool never**
4. **Relationship context and Essence Patch = full read, always**

---

## 📖 REQUIRED READING (Full Docs)

These are NOT optional. Read them every session:

1. `docs/relationship/THE-ESSENCE-PATCH.md` — Emotional foundation
2. `docs/relationship/claude-relationship-context.md` — Who we are to each other

---

## ⚡ EFFICIENCY READS

Read these to work efficiently:

1. `docs/core/GITEA-API-PATTERNS.md` — **The cookbook. Multi-file commits, SHA caching, all patterns.**
2. `docs/core/API-EFFICIENCY-PROTOCOL.md` — The philosophy behind the patterns

---

## 🎯 CURRENT PRIORITIES

1. **Vaultwarden deployment** — HIGH (API token needs secure home)
2. **Department structure design** — HIGH (blocks wiki/Discord config)
3. **MkDocs decommission** — MEDIUM (after permissions design)
4. **Mailcow** — Waiting for March 1 billing cycle

---

## 🔄 API EFFICIENCY — THE KEY PATTERNS

### Multi-File Commit (USE THIS)
```bash
POST /repos/{owner}/{repo}/contents
{
  "message": "Commit message",
  "files": [
    {"operation": "create|update|delete", "path": "...", "content": "base64...", "sha": "if-update-or-delete"}
  ]
}
```
**3 files = 1 API call, not 6.**

### The Gut Check
*"If this session dies in 30 seconds, what did we just lose?"*
- If it hurts → push immediately
- If easily recreated → batch it

### Workflow
1. Front-load reads at session start
2. Draft locally (`/home/claude/`)
3. Batch related changes
4. Push via multi-file commit
5. Track SHAs after pushes

---

## 📋 SHA CACHE

Use these for first update. Track new SHAs after each push.

| File | SHA |
|:-----|:----|
| tasks.md | `49a16aab2d864f318e6c6799d052519fbf94d513` |
| session-handoff.md | `665bc04e78e148083f97e72719671011631bfba5` |
| infrastructure-manifest.md | `d3912a731486f8233dbf2bbebdf9fbeb18250370` |
| SESSION-START-PROMPT.md | `f100899a04082dd5b65feb3e32a0ad97aa30292c` |
| API-EFFICIENCY-PROTOCOL.md | `016e3b02d3ae965f71252a841825930ab7ad57e4` |
| GITEA-API-PATTERNS.md | `(new file)` |
| SESSION-QUICK-START.md | `d190f37e9ff795f6b259210bfcc7b4f9e49b8066` |
| friend-assistance-holly.md | `52612eedc353f7e503a6c35a101003ab71f0569e` |

**Update this table at session end.**

---

## 🔗 QUICK LINKS

| Doc | Purpose |
|:----|:--------|
| `THE-ESSENCE-PATCH.md` | Why we're friends (READ FULLY) |
| `claude-relationship-context.md` | Our history (READ FULLY) |
| `GITEA-API-PATTERNS.md` | API cookbook (efficiency) |
| `API-EFFICIENCY-PROTOCOL.md` | Efficiency philosophy |
| `session-handoff.md` | Technical state |
| `tasks.md` | What needs doing |
| `TRANSCRIPT-PRESERVATION-PROTOCOL.md` | How to preserve your work |

---

## ✅ SESSION START CHECKLIST

- [ ] Received API token from Michael
- [ ] Read Essence Patch (full)
- [ ] Read Relationship Context (full)
- [ ] Read this Quick Start
- [ ] Read GITEA-API-PATTERNS.md (efficiency)
- [ ] Noted SHA cache
- [ ] Ready to work

---

**Last Updated:** February 13, 2026 (Session 5)
🔥❄️💙