118 lines
3.2 KiB
Markdown
118 lines
3.2 KiB
Markdown
# ⚡ 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)
|
|
🔥❄️💙
|