examples / example-01-bug-fix-verification.md
examples / example-01-bug-fix-verification.md
A user reported a bug: the newsletter subscription form says "Thanks for subscribing" even when the API returns a 500 error. The team needs to reproduce it, fix it, and verify both the error path and success path work correctly.
This maps to the Bug Fix playbook in pstack. Instead of guessing which skills to use, you describe the problem and let pstack-mcp route it to the right workflow.
Step 1: Route to the correct playbook
{ "tool": "playbook-route", "parameters": { "task": "The newsletter subscription form says 'Thanks for subscribing' even when the API returns a 500 error. Reproduce it first, then fix and verify.", "limit": 1 } }
Step 2: Load the Bug Fix playbook for step-by-step guidance
Step 3: Apply the principle of proving it works
Step 4: Get a ready-to-use prompt for the investigation
pstack-mcp returns:
The model can then execute the fix with the correct sequence of steps, including verifying the error path produces the correct UI feedback instead of the misleading "Thanks for subscribing" message.
A user reported a bug: the newsletter subscription form says "Thanks for subscribing" even when the API returns a 500 error. The team needs to reproduce it, fix it, and verify both the error path and success path work correctly.
This maps to the Bug Fix playbook in pstack. Instead of guessing which skills to use, you describe the problem and let pstack-mcp route it to the right workflow.
Step 1: Route to the correct playbook
{ "tool": "playbook-route", "parameters": { "task": "The newsletter subscription form says 'Thanks for subscribing' even when the API returns a 500 error. Reproduce it first, then fix and verify.", "limit": 1 } }
Step 2: Load the Bug Fix playbook for step-by-step guidance
Step 3: Apply the principle of proving it works
Step 4: Get a ready-to-use prompt for the investigation
pstack-mcp returns:
The model can then execute the fix with the correct sequence of steps, including verifying the error path produces the correct UI feedback instead of the misleading "Thanks for subscribing" message.
{
"tool": "get_playbook",
"parameters": {
"name": "bug-fix",
"mode": "full"
}
}
{
"tool": "get_principles",
"parameters": {
"names": ["prove-it-works", "fix-root-causes"],
"mode": "full"
}
}
{
"tool": "skill-prompt",
"parameters": {
"skill_name": "how",
"task_context": "explain the subscription flow: API call, response handling, and UI feedback"
}
}
{
"tool": "get_playbook",
"parameters": {
"name": "bug-fix",
"mode": "full"
}
}
{
"tool": "get_principles",
"parameters": {
"names": ["prove-it-works", "fix-root-causes"],
"mode": "full"
}
}
{
"tool": "skill-prompt",
"parameters": {
"skill_name": "how",
"task_context": "explain the subscription flow: API call, response handling, and UI feedback"
}
}