# Systematic Bugfix Workflow

> A systematic workflow to debug faster with Claude.ai for rapid hypothesis generation and Claude Code for autonomous investigation, fixes, and verification.

- Skill: `uygnoey/systematic-bugfix-workflow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add uygnoey/systematic-bugfix-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/uygnoey/systematic-bugfix-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: uygnoey (https://skillmd.com/u/uygnoey)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/uygnoey/systematic-bugfix-workflow

---


## Instructions

Follow this workflow to go from symptoms to a verified fix.

1. Gather evidence
   - Capture stack traces, logs, reproduction steps, and the expected vs actual behavior.

2. Triage with Claude.ai (fast)
   - Ask for a ranked list of probable root causes and what to inspect.
   - Use the templates in [templates/debugging-prompts.md](./templates/debugging-prompts.md).

3. Escalate to Claude Code (deep)
   - In your repo, start Claude Code and describe the bug and evidence.
   - Ask it to search for the relevant code paths, propose a fix, and request permission before edits.

4. Validate
   - Ask for a reproduction test.
   - Run the test suite and confirm what changed.
   - Request an explanation of the changes.

5. Ship safely
   - If appropriate, ask Claude Code to commit changes and open a PR.
   - Monitor for regressions and add coverage for the failure mode.

## Examples

- "Here's a test failure from CI. What could be causing it?" (triage)
- "probable root causes ranked by likelihood" (log analysis)
- "Write a test that reproduces this bug" (validation)
- "Commit these changes and open a PR" (shipping)