← ClaudeAtlas

debuglisted

Debug router — choose between auto (agent-verified, narrow code fix) and manual (user-verified, deep spec context, in-place spec reconciliation)
blake-simpson/belmont · ★ 4 · AI & Automation · score 73
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