debuglisted
Install: claude install-skill blake-simpson/belmont
# Belmont: Debug
This is the debug router. It directs you to the appropriate debug sub-workflow.
## Two Modes
| Mode | Skill | Verification | Best for |
|------|-------|-------------|----------|
| **Auto** | `/belmont:debug-auto` | Verification agent checks each fix | Complex logic bugs, race conditions, issues needing automated testing, narrow code-only fixes |
| **Manual** | `/belmont:debug-manual` | User checks each fix (adds debug logs); deep Belmont context + in-place spec reconciliation after the fix | UI bugs, visual issues, known repro steps, **bugs that exist because the spec drifted from reality**, multi-feature debugging |
The two modes diverge sharply after the fix is confirmed:
- **Auto** commits the code change and ends. The PRD, TECH_PLAN, NOTES stay as they are.
- **Manual** runs a Spec Reconciliation phase that walks the loaded specs, identifies drift, presents diffs for user approval, and commits code + spec edits atomically. This is how Belmont's memory gets corrected so future sessions don't operate on stale truth.
## Route Decision
Check the user's invocation text for mode hints:
**Route to `/belmont:debug-auto`** if the user mentions:
- "auto", "automatic", "full verification", "run tests", "agent verify"
- "just the code", "narrow fix", "don't touch specs"
- Complex or hard-to-reproduce issues where agent-driven iteration beats user-in-the-loop
**Route to `/belmont:debug-manual`** if the user mentions:
- "manual", "I'll check", "I'll verify", "I