Files
firefrost-operations-manual/docs/core/SESSION-QUICK-START.md

3.2 KiB

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.mdThe 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)

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.


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) 🔥❄️💙