Add SESSION-QUICK-START.md - lean orientation with SHA cache
This commit is contained in:
101
docs/core/SESSION-QUICK-START.md
Normal file
101
docs/core/SESSION-QUICK-START.md
Normal file
@@ -0,0 +1,101 @@
|
||||
# ⚡ 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 (This Doc Covers Basics)
|
||||
|
||||
Only read full versions if you need deep context:
|
||||
|
||||
- `docs/core/session-handoff.md` — Full technical state
|
||||
- `docs/core/tasks.md` — Full task list
|
||||
- `docs/core/infrastructure-manifest.md` — Full infrastructure details
|
||||
|
||||
---
|
||||
|
||||
## 🎯 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 PROTOCOL
|
||||
|
||||
**The Gut Check:** "If this session dies in 30 seconds, what did we just lose?"
|
||||
|
||||
- **If the answer hurts → push immediately**
|
||||
- **If easily recreated → batch it**
|
||||
|
||||
**Workflow:**
|
||||
1. Front-load reads at session start
|
||||
2. Work locally (artifacts/local files)
|
||||
3. Push once per logical unit
|
||||
4. Track SHAs after pushes (use cache below)
|
||||
|
||||
---
|
||||
|
||||
## 📋 SHA CACHE
|
||||
|
||||
Use these for first update to each file. Track new SHAs after pushes.
|
||||
|
||||
| File | SHA |
|
||||
|:-----|:----|
|
||||
| tasks.md | `49a16aab2d864f318e6c6799d052519fbf94d513` |
|
||||
| session-handoff.md | `cb422fd39c206f391dde07920440da6c11e1ff0e` |
|
||||
| infrastructure-manifest.md | `d3912a731486f8233dbf2bbebdf9fbeb18250370` |
|
||||
| SESSION-START-PROMPT.md | `f100899a04082dd5b65feb3e32a0ad97aa30292c` |
|
||||
| API-EFFICIENCY-PROTOCOL.md | `016e3b02d3ae965f71252a841825930ab7ad57e4` |
|
||||
| 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) |
|
||||
| `session-handoff.md` | Technical state |
|
||||
| `tasks.md` | What needs doing |
|
||||
| `API-EFFICIENCY-PROTOCOL.md` | How to work efficiently |
|
||||
| `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
|
||||
- [ ] Noted SHA cache
|
||||
- [ ] Ready to work
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** February 13, 2026 (Session 5)
|
||||
🔥❄️💙
|
||||
Reference in New Issue
Block a user