┌─────────────────────────────────────────────────────────┐
│  ⚡ ATOMIC LAYER — do one thing, no side effects        │
│                                                         │
│  /commit       commit & push (conventional commits)     │
│  /log          log file + D1 log + D1 velocity          │
│  /ongoing      add/update/remove ongoing.md entries     │
│  /discuss       discussion mode (no execution)           │
│  /hub-status   read-only daily pulse                    │
│  /hub-clean    data hygiene: logs, tasks, git            │
│  /hub-archive  archive done tasks + old logs             │
│  /skill        create new skill                         │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│  🔵 TASK LIFECYCLE — track work from start to finish    │
│                                                         │
│  /task start   config → folder? → D1? → comments? →    │
│                resume or create                         │
│  /task save    /commit → D1 sync → audit comment → /log │
│  /task done    ongoing + D1 + audit comment (atomic)    │
│  /task archive move to archive                          │
│  /task spawn   full work package for later              │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│  🟠 SESSION LIFECYCLE — capture, assess, transition     │
│                                                         │
│  /session save     full reasoning trail (by topic)      │
│  /session summary  quick session status (chat)          │
│  /session health   subjective quality gauge             │
│                    → if <60%: suggest /handoff           │
│  /session quality  rate smoothness + hypotheses         │
│  /handoff          save state → next-session.md         │
│                    → consider /task spawn               │
│                    → suggest /wrapup                    │
└─────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────┐
│  🎯 ORCHESTRATOR — compose atomics into sequences       │
│                                                         │
│  /wrapup session                                        │
│    0.5  handoff check   (if degraded → /handoff first)  │
│    1.   /session save   (if discussion)                 │
│    2.   /learn    (if learnings)                  │
│    3.   /learn scan     (if KB-worthy)                  │
│    4.   /hub-evolve   (if hub changed)                │
│    5.   /task done|save (always)                        │
│    6.   /log            (always)                        │
│    7.   /commit         (always)                        │
│    8.   wellness check  (always)                        │
│                                                         │
│  /wrapup day                                            │
│    → run /wrapup session for each active task            │
└─────────────────────────────────────────────────────────┘


## Composition Map — Who Calls Who

/wrapup ─────┬─ /session save
             ├─ /learn
             ├─ /learn scan
             ├─ /hub-evolve
             ├─ /task done ─── /ongoing
             ├─ /log
             └─ /commit

/handoff ────┬─ /task spawn   (if scope grew)
             └─ suggests → /wrapup

/task save ──┬─ /commit
             └─ /log

/task start ─── check folder → check D1 → read comments
                → resume or create


## Task Start Decision Matrix

┌──────────────┬───────────┬───────────────────────────────┐
│ Local Folder │ D1 Record │ Action                        │
├──────────────┼───────────┼───────────────────────────────┤
│ ✅ exists    │ ✅ exists │ Resume — read README, go      │
│ ✅ exists    │ ❌ missing│ Resume + create D1 record     │
│ ❌ missing   │ ✅ exists │ Fresh start with D1 context   │
│ ❌ missing   │ ❌ missing│ Fully new — ask user          │
└──────────────┴───────────┴───────────────────────────────┘


## Alignment Zoom Levels

  🔭 /vision align   = LIFE    stress, energy, balance (quarterly)
  📅 /clara align   = WEEK    rank tasks, set tiers (weekly)
  🎯 /vision check  = WORK    does this serve the compass? (per-task)


## Session Ending Decision

  Session ending?
  ├─ YES → Context degraded?
  │         ├─ YES → /handoff → /wrapup
  │         └─ NO  → /wrapup
  │
  └─ NO  → What am I doing?
            ├─ Working        → /task save  or  /commit
            ├─ Need direction → /vision align | /clara align | /vision
            ├─ Quick pulse    → /hub-status
            ├─ Discussion     → /discuss
            └─ Process inbox  → /clara sweep


## Handoff Flow

  Context dropping
    │
    ├─ /session save (if unsaved discussion)
    │
    └─ /handoff
         ├─ assess: what's done / remaining / decisions
         ├─ same task? → write next-session.md in task folder
         │  scope grew? → /task spawn new work package
         ├─ update D1 context + audit comment
         └─ suggest /wrapup
              │
              └─ /wrapup closes the session