# Issue Breakdown

## Epic 1 — Operator shell foundation

- add doctor command
- add refresh semantics
- machine-readable diagnostics mode
- install / uninstall preservation tests

## Epic 2 — Hook manager

- ownership model
- adapter abstraction
- merge-safe renderer
- uninstall-safe cleanup
- doctor integration

## Epic 3 — Run-state v2

- run manifest
- child index
- gate snapshots
- recovery checkpoints
- migration compatibility layer

## Epic 4 — Operator cockpit

- watch data model
- TUI panels
- recovery hints
- snapshot export

## Epic 5 — Workflow aliases and scaffolding

- alias registry
- lowering renderer
- AGENTS template
- library / gate scaffolds
- generated flow preview

## Epic 6 — Team supervisor

- topology manifest
- team-status
- team-resume
- team-stop
- optional worktree adapter spike

## Epic 7 — Docs and rollout

- docs/wip landing
- roadmap annotation if accepted
- troubleshooting docs
- promotion checklist
