fix

Guide bug fixing by reproducing issues, triaging, testing, and committing changes.

89|32|Updated May 28, 2026

Search Tags:#TDD #software development #bug fixing #AI-assisted #spec-first

Ready to run

npx skills add https://github.com/genkovich/sdd --skill fix-genkovich

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: fix
Source: https://github.com/genkovich/sdd/tree/main/skills/fix
Command: npx skills add https://github.com/genkovich/sdd --skill fix-genkovich

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the process of fixing bugs by guiding you through a structured approach, ensuring that each step is completed thoughtfully and methodically.

Core Features & Use Cases

Spec-first Approach: Guides you in reproducing the bug, tracing it to the acceptance criteria, and applying a fix.
Triage: Helps determine whether the issue is a regression, a spec-bug, or a gap.
Test Automation: Writes and runs tests to verify the fix.
Spec Patching: Applies necessary changes to the spec document.
Committing Changes: Commits the fix with proper trailers and handoff information.
Use Case: When you encounter a bug in your codebase, use the 'fix' skill to systematically address it, ensuring both the code and the spec are updated accordingly.

Quick Start

Run the 'fix' skill with the command: /sdd:fix

Frequently Asked Questions about fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

What is a spec-first approach to bug fixing?▼

Spec-first bug fixing involves tracing a bug to its acceptance criteria before applying a fix, ensuring the code and specification stay aligned. It guides you to reproduce the bug, update the spec document, and commit changes methodically.

How do I use AI to triage software bugs and regressions?▼

You can use AI-assisted triaging to classify a bug as a regression, a spec-bug, or a gap. The process evaluates the issue against existing specifications to determine the exact nature of the software defect before writing tests.

How do I automate tests when fixing a bug in a TDD workflow?▼

To automate tests during bug fixing, the AI-assisted process writes and runs tests to verify the fix after tracing the issue to the spec. This ensures the regression is captured and resolved within the test-driven development cycle.

Can I use guided bug fixing for product management spec updates?▼

Yes, developers and product managers can use this bug fixing process to patch specification documents. It applies necessary changes to the spec and commits them with proper trailers and handoff information for the team.

What's the best way to commit a bug fix with updated specifications?▼

The best way to commit a bug fix is by including proper trailers and handoff information alongside the code and spec updates. This structured approach ensures both the fix and the acceptance criteria changes are tracked together.

When should I use an AI-assisted bug fixing workflow over manual patching?▼

Use AI-assisted bug fixing when you need a structured, TDD-aligned process to systematically address issues. It is ideal when you must reproduce bugs, automate verification tests, patch specifications, and commit changes methodically rather than applying quick manual patches.