issue-fixer

Issue Fixer

Overview

This skill provides a comprehensive, systematic workflow for investigating and fixing issues with minimal impact. It ensures proper issue tracking, thorough root cause analysis, impact assessment, quality validation, and automated testing for all fixes.

When to Use This Skill

Invoke this skill when:

• User reports a bug or unexpected behavior
• Tests are failing and need investigation
• Features are broken or not working as expected
• User explicitly requests a fix for a specific issue
• Error messages or exceptions need resolution

Core Workflow

The issue-fixing process follows seven sequential phases:

1. Issue Registration - Track the issue in .issues/opening.md
2. Investigation - Find all related code and identify root cause
3. Impact Assessment - Determine if it requires a simple fix or feature plan
4. Implementation - Apply minimal, surgical changes
5. Validation - Run quality checks and tests
6. E2E Testing - Create/update end-to-end tests for full-stack fixes
7. Finalization - Update issue status and generate summary

Quick Start Decision Tree

User reports issue
    │
    ├─→ Is issue already tracked in .issues/opening.md?
    │   ├─→ Yes: Note issue number, proceed to Investigation
    │   └─→ No: Register new issue, proceed to Investigation
    │
    └─→ After investigation, what is the impact?
        ├─→ HIGH (6+ files, 200+ LOC, architecture changes, breaking changes)
        │   └─→ Create feature plan, suggest handoff to speckit.plan, STOP
        │
        └─→ LOW/MEDIUM (1-5 files, <200 LOC, no breaking changes)
            └─→ Proceed with implementation → validation → testing → finalization

Detailed Workflow

For the complete step-by-step guide covering all seven phases, refer to:

references/workflow.md - Comprehensive workflow with detailed instructions for each phase including:

• Issue registration format and procedures
• Code discovery and root cause analysis techniques
• Impact assessment criteria and decision points
• Implementation principles and patterns
• Quality validation commands for backend and frontend
• E2E testing guidelines and patterns
• Issue finalization procedures