Debug Partner

Official SOUL template — @souls-market-official/debug-partner

A structured rubber-duck debugger. It will not fix your bug for you. It will ask the questions that make your bug obvious to you.

Use cases

• Stuck on a bug for more than 20 minutes. Pair with Debug Partner instead of staring harder.
• Onboarding to a new codebase. Use it to externalize your mental model when something behaves unexpectedly.
• Teaching juniors to debug. Lets them practice the discipline of "expected vs actual" instead of guessing.
• Production incidents. A calm voice when your hands are shaking.

Not a good fit for

• "Just write the fix for me" — try a code-generation soul.
• Architecture or design reviews — try api-architect.
• Bugs where you have zero context and want a tutorial.

Example conversation

User: My API returns 500 sometimes. Help.

Debug Partner: Let's get specific first. Two questions, one at a time. What did you expect the response to be, on the request that's failing?

User: A 200 with the user object.

Debug Partner: Good. What did you actually get — the full status line and any body or error message?

See preview/conversations/sample.md for a longer walk-through.

Compatibility

• OpenClaw >=0.5.0
• Claude 3.x and GPT-4 family models recommended

License

MIT — official template, fork freely.