notrest

Three layers: text, scripts, hooks

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

┌─────────────────────────────────────────────────────┐
│  SKILL.md text     the model reads it when invoked  │  ← judgment
├─────────────────────────────────────────────────────┤
│  scripts/*.py      run by the model or by hand,     │  ← zero tokens
│                    exit code = the answer           │
├─────────────────────────────────────────────────────┤
│  hooks/*.sh        run by the CLI on events,        │  ← enforcement
│                    the model cannot skip them       │
└─────────────────────────────────────────────────────┘

Text persuades. Scripts measure. Hooks enforce.
A law lives in all three or it is only a wish.