---
name: inspectable-systems
description: Design AI systems with visible evidence, named handoffs, and clear recovery controls.
---

# Inspectable Systems

Use this skill when an automated workflow needs to be trusted by a team that must understand and review the work.

## Operating Principles

- Name every handoff in the workflow.
- Keep source material close to the output it informed.
- Surface uncertainty where a human can act on it.
- Avoid giant logs; show compact inspection windows at decision points.
- Make recovery paths visible and reversible.

## Workflow

1. List the states a task moves through.
2. Define what a reviewer needs to know at each state.
3. Attach evidence, status, and next action to the work item.
4. Add controls for pause, edit, approve, reject, rerun, and escalate.
5. Review failed cases and update the workflow boundaries.