nickcrew/workflow-bug-fix

Bug Fix Workflow

Systematic process for fixing bugs properly.

Phase 1: Root Cause Analysis

Agents: root-cause-analyst

Methods:

• Error trace analysis
• Log investigation
• State inspection
• Reproduce the bug consistently

Output: Root cause, affected components, impact assessment

Phase 2: Fix Implementation

Constraints:

• Minimal scope (fix the bug, nothing more)
• Backward compatible
• Well tested

Phase 3: Code Review

Agents: code-reviewer

Focus:

• Fix correctness
• Side effects
• Edge cases

Phase 4: Regression Testing

Agents: test-automator

Create tests:

• Regression test (prevents this bug from returning)
• Edge case tests
• Integration tests if affected

Phase 5: Security Check

Agents: security-auditor

Blocking: Ensure fix doesn't introduce vulnerabilities

Phase 6: Validation

Agents: quality-engineer

Checklist:

• [ ] Original issue resolved
• [ ] No new issues introduced
• [ ] All tests pass

Phase 7: Documentation

Agents: technical-writer

• Changelog entry
• Incident report (for significant bugs)
• Prevention guide (what caused it, how to avoid)

Phase 8: Deployment

Agents: deployment-engineer

Strategy: Hotfix if critical, normal release otherwise

Monitor for 24h:

• Error rate
• Performance metrics
• User reports

Success Criteria

• [ ] Bug verified fixed
• [ ] Regression tests added
• [ ] No side effects
• [ ] Documentation updated

Anti-patterns

• ❌ Fixing symptoms instead of root cause
• ❌ Large scope changes mixed with bug fix
• ❌ Skipping regression tests
• ❌ No documentation of what caused it