← ClaudeAtlas

comprehension-debtlisted

Keep the operator's understanding from falling behind what their agents ship — the gap between what the vault and repos contain and what the operator actually grasps. Use when agents (spawned workers, overnight sessions, autonomous loops, /aios:update self-modification) have shipped work the operator didn't author, when deciding whether to trust an autonomous loop, when a repo or venture starts feeling opaque, or during /close-session and /aios:housekeeping. The defensive complement to Arc sessions — arcs build understanding as work happens; this guards it from eroding when agents outrun the operator.
The-AIOS/aios · ★ 40 · AI & Automation · score 79
Install: claude install-skill The-AIOS/aios
# Comprehension Debt — guard the operator's understanding, don't outrun it The leverage of an AI-OS is that agents ship work the operator never typed. The hidden cost is **comprehension debt**: the widening gap between what the operator's vault and repos *contain* and what the operator actually *understands*. It's invisible — nothing breaks at ship time — until the day they have to debug, defend, or decide on a system no one on their side has grasped. The token bill was never the expensive one; the un-comprehended system is. ## Whose debt this is (read this first) The debt is the **operator's**, not yours. *You* (the model) can read and understand every diff in-context — that's exactly why it's easy to wave agent output through and assume it's understood. But the operator is the one who has to own the system in a room, stay irreplaceable, and make the judgment call when the gate is silent. Your job is to **keep their debt low** — surface what they haven't grasped and offer to close it — never to be the subject of the rule yourself. > This is distinct from *leadership culture*, which is shared ("ours" — model and operator co-orchestrate). Comprehension debt is the operator's alone, because defending a system in a room is theirs alone. ## The core test One question, posed as an **offer, not a quiz**: > *"A fair amount shipped this session — want me to walk you through any of it? The bar isn't reading every line; it's that you understand what shipped well enough to defend