What runs when (the seven events)

Part 1 · PLUGIN STRUCTURE AND ARCHITECTURE · Slide 5 of 60

Runtime event        hook                     what it does
──────────────────   ───────────────────────  ─────────────────────────
SessionStart         session-start.sh         banner, laws, the packet
UserPromptSubmit     coord-nudge.sh           "log this prompt's work"
                     router.sh                "this looks like /verb"
PreToolUse (Agent)   spawn-gate.sh            refuses unlawful spawns;
                                              injects lessons; arms gates
PreToolUse (Bash)    pretool-gate.sh          ship gate, shadow guard
SubagentStop         agent-ledger.sh          receipts every lane; banks its card
Stop                 completion-gate.sh       "done" must earn itself:
                                              gates · lessons · open questions
PreCompact           pre-compact.sh           bank before memory shrinks
SessionEnd           session-end.sh           crash cushion, ledger roll

Every command declares its own timeout. Every hook fails OPEN
and silent: a broken hook never takes the session down.