comprehension-debtlisted
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