speckit-bugfix-patch

Patch spec, plan, and task artifacts to fix reported bugs.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/datamonsterr/mycoai_projects --skill speckit-bugfix-patch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-bugfix-patch
Source: https://github.com/datamonsterr/mycoai_projects/tree/main/.agents/skills/speckit-bugfix-patch
Command: npx skills add https://github.com/datamonsterr/mycoai_projects --skill speckit-bugfix-patch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Surgically update spec, plan, and tasks to address a reported bug — adds missing requirements, fixes conflicts, reopens false completions, and adds new tasks. Minimal changes only, never regenerates from scratch.

Core Features & Use Cases

  • Patch artifacts (spec.md, plan.md, tasks.md) to fix bugs described in a bug report.
  • Apply patch types: spec gap, spec conflict, implementation drift, untested flow, and dependency issue.
  • Preserve history with minimal changes and bugfix notes.

Quick Start

Provide a bug report or bug ID, then run the speckit-bugfix-patch procedure to apply surgical updates.

Frequently Asked Questions about speckit-bugfix-patch

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

FAQPage Schema
How do I patch spec-kit artifacts to fix a reported bug?

To patch spec-kit artifacts, provide a bug report or bug ID to apply surgical updates to spec.md, plan.md, and tasks.md. This adds missing requirements, fixes conflicts, and updates statuses while preserving history and applying bugfix metadata.

What types of bugs can I fix by patching spec, plan, and tasks files?

Patching spec, plan, and tasks files resolves spec gaps, spec conflicts, implementation drift, untested flows, and dependency issues. It reopens false completions, adds new tasks, and modifies only the necessary artifact sections.

Can I update spec.md and plan.md without regenerating the entire specification?

Yes, you can update spec.md and plan.md without regenerating from scratch. The patch procedure applies minimal changes to the affected artifacts, ensuring patch notes and bugfix metadata are added while preserving the existing history.

What is the best way to add missing requirements to a tasks.md file?

The best way to add missing requirements to tasks.md is using a targeted bugfix patch. It surgically modifies the artifact to address the reported gap, adds the necessary tasks, and updates the completion status without rewriting the entire file.

Why does my spec-kit bugfix patch only modify parts of the spec and plan?

A spec-kit bugfix patch only modifies parts of the spec and plan to ensure surgical changes. By preserving history and applying minimal updates, it prevents unnecessary overwrites and maintains the integrity of the original artifacts.

Do I need a bug report to apply patch updates to spec-kit tasks?

Yes, you need a bug report or bug ID to apply patch updates to spec-kit tasks. The procedure targets affected artifacts based on the described issue, ensuring the surgical changes accurately address the reported bug.