Bug Fixing

Goal

Fix the smallest safe root cause.

Best Tools

  • Codex
  • Claude Code
  • Aider
Investigate first.
Return root cause, minimal fix plan, and validation steps before editing.

Step-by-Step

  1. understand symptoms
  2. identify root cause
  3. implement minimal fix
  4. run narrow tests

CLI Examples

claude
codex
aider

IDE Examples

  • use Cursor or Copilot chat with local files open and logs attached

Review Checklist

  • root cause is addressed
  • fix is scoped

Common Mistakes

  • fixing only the symptom

Team Standard

Plan first on production bugs.