Skip to content

feat: add debugging workflow guidance via MCP prompts, skills, and docs#11

Merged
derekparker merged 2 commits into
masterfrom
feat/debugging-workflow-guidance
Mar 11, 2026
Merged

feat: add debugging workflow guidance via MCP prompts, skills, and docs#11
derekparker merged 2 commits into
masterfrom
feat/debugging-workflow-guidance

Conversation

@derekparker

Copy link
Copy Markdown
Member

Summary

  • Adds 4 MCP prompts (debug-source, debug-attach, debug-core-dump, debug-binary) in prompts.go — always-available guided workflows returned via prompts/get
  • Adds 4 Claude Code skill files in docs/superpowers/skills/ with trigger conditions, step-by-step tool sequences, decision trees, and root-cause pattern guides
  • Adds docs/debugging-workflows.md with a decision table, Mermaid diagrams for each scenario, and common gotchas
  • Updates CLAUDE.md to document the new prompts, skills, and workflow reference
  • Wires registerPrompts() into main.go server startup

Adds four complementary layers of workflow guidance for AI assistants
using mcp-dap-server, covering source debug, attach, core dump, and
binary/assembly scenarios:

- prompts.go: 4 MCP prompt handlers (debug-source, debug-attach,
  debug-core-dump, debug-binary) registered via registerPrompts(),
  each returning a structured step-by-step tool invocation guide
- docs/superpowers/skills/: 4 Claude Code skill files with trigger
  conditions, decision trees, and root-cause patterns per scenario
- docs/debugging-workflows.md: human-readable reference with decision
  table, Mermaid workflow diagrams, and common gotchas
- CLAUDE.md: documents prompts.go, skill files, and workflow reference
- main.go: wires registerPrompts() into server startup

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Comment thread docs/superpowers/skills/debug-attach.md Outdated
Comment thread skills/debug-attach.md
Comment thread skills/debug-attach.md
Comment thread docs/superpowers/skills/debug-binary.md Outdated
Comment thread skills/debug-source.md
Comment thread skills/debug-source.md
Comment thread CLAUDE.md Outdated
Comment thread prompts.go Outdated
- Move skills from docs/superpowers/skills/ to top-level skills/
- stop tool: add detach=true parameter to disconnect without terminating
  the debuggee (sends DAP disconnect with terminateDebuggee=false)
- debug-attach skill: note that debug() already returns initial context;
  only call context() after resuming; add C/C++ thread/lock indicators
  and memory-leak examples alongside Go examples; document stop(detach=true)
- debug-binary skill: note that step() returns context automatically
- debug-source skill: add language-specific evaluate() expression syntax
  for Delve (Go) and GDB (C/C++); expand common patterns table to cover
  Go, C/C++, and Rust root causes
- Update CLAUDE.md and docs/debugging-workflows.md for new skills/ path

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@derekparker derekparker merged commit fd732ee into master Mar 11, 2026
1 check passed
@derekparker derekparker deleted the feat/debugging-workflow-guidance branch March 11, 2026 22:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant