Workflow Architecture

28 workflows organized in 4 layers. Design principle: Composable & Atomic (SC5) — each does ONE thing, complex operations compose atomics.

Created: A122 (2026-03-21). Updated: A132 (2026-03-29), A139 (2026-03-31), A146 (2026-04-01).

System Map — 4 Layers

┌───────────────────────────────────────────────────────────────┐
│  ⚡ ATOMIC — 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)                 │
│  /status       read-only daily pulse                          │
│  /hub-clean    data hygiene: logs, tasks, git                 │
│  /hub-archive  archive done tasks + old logs + reports        │
│  /hub-compact  compress: stale models, clarity, merge/retire  │
│  /remind       quick add to agent-notes.md                    │
└───────────────────────────────────────────────────────────────┘

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

┌───────────────────────────────────────────────────────────────┐
│  🟠 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                  │
└───────────────────────────────────────────────────────────────┘

Additional Workflows (cross-cutting)

Workflow	Layer	Purpose
`/learn`	Knowledge	Extract & store session learnings → rules/memory/KB
`/learn scan`	Knowledge	Scan workspace for KB-worthy content
`/hub-evolve`	Maintenance	Sync docs/architecture after hub changes
`/hub-audit`	Maintenance	Quality inspection against principles
`/clara`	Dispatch	Sweep inbox, classify, route to workspaces
`/research`	Thinking	Research topic, produce report
`/clarity`	Assessment	Measure context crystallization
`/vision`	Alignment	Check vision chain alignment
`/distill`	Knowledge	Process long-form content into structured knowledge
`/ingest`	Capture	Route Smart Todo items into hub
`/write-blog`	Thinking	Create blog post from session insights
`/problem`	Capture	Dump, triage, and map problems (AC13)
`/focus`	Thinking	Problem-first laser focus prioritization
`/worthit`	Thinking	Challenge ideas before building (做得到 ≠ 该做)
`/pullall`	Operations	Git pull all workspaces + submodules
`/pushall`	Operations	Git push all workspaces + submodules

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

Strategic Workflows

Alignment — Three Zoom Levels

Zoom	Workflow	Cadence	Question
🔭 LIFE	`/vision align`	Quarterly	Stress? Energy? Life balance?
📅 WEEK	`/clara`	Weekly	Which tasks this week? Triage inbox?
🎯 WORK	`/vision`	Per-task	Does this serve the vision chain?

Assessment

Workflow	Scope	Output
`/clarity`	Project/domain	How crystallized is the context?
`/hub-audit`	Hub system	Quality inspection against principles
`/status`	Daily	Read-only pulse check

Hub Maintenance Cycle (CE10 Closed Loop)

/hub-evolve  →  /hub-compact  →  /hub-audit  →  /hub-evolve
   (sync)         (compress)       (validate)      (repeat)

Decision Flow — "What Do I Call?"

Session ending?
├─ YES → Context degraded?
│         ├─ YES → /handoff → /wrapup
│         └─ NO  → /wrapup
│
└─ NO  → What am I doing?
          ├─ Working        → /task save  or  /commit
          ├─ Need direction → /vision align (life) | /clara (week) | /vision (task)
          ├─ Quick pulse    → /status
          ├─ Discussion     → /discuss
          ├─ Problem dump   → /problem
          └─ Process inbox  → /clara

Task Start Decision Matrix

Local Folder	D1 Record	Action
✅	✅	Resume — read README, go
✅	❌	Resume + create D1 record
❌	✅	Fresh start with D1 context
❌	❌	Fully new — ask user

Workflows

On this page