rai-bugfix-plan

Decompose bug fixes into atomic TDD tasks with verification commands.

71|8|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/humansys/raise --skill rai-bugfix-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rai-bugfix-plan
Source: https://github.com/humansys/raise/tree/main/packages/raise-cli/src/raise_cli/skills_base/rai-bugfix-plan
Command: npx skills add https://github.com/humansys/raise --skill rai-bugfix-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turn a root-cause bug analysis into an explicit, regression-first implementation plan so fixes are delivered as small, independently verifiable commits and regressions are prevented from recurring.

Core Features & Use Cases

  • Decomposes a bug fix into atomic tasks ordered for Test-Driven Development, with the regression test as the first task.
  • Requires an analysis artifact and produces work/bugs/RAISE-{N}/plan.md containing task descriptions, verification commands, and commit-message templates.
  • Use cases include routine bug fixes, small to medium maintenance work, and enforcing reproducible, reviewable change sets on a bug branch.

Quick Start

Create work/bugs/RAISE-123/plan.md listing a failing regression test as task one followed by discrete fix and refactor tasks with verification commands and commit message templates.

Frequently Asked Questions about rai-bugfix-plan

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

FAQPage Schema
How do I convert a root cause bug analysis into a TDD task plan?

To convert a root cause bug analysis into a TDD task plan, this Skill decomposes the fix into atomic tasks ordered for Test-Driven Development, ensuring the regression test is the first task. It generates a structured plan with verification commands and commit-message templates.

How do I structure bug fixes into atomic commits with regression tests?

Structuring bug fixes into atomic commits with regression tests requires ordering tasks so the failing test is written first, followed by discrete fix and refactor tasks. This approach ensures each commit is independently verifiable and prevents regressions from recurring.

What is a regression-first implementation plan for bug fixes?

A regression-first implementation plan for bug fixes is a TDD-oriented task decomposition where the regression test is the initial task, followed by independent fix and refactor tasks. It produces a plan.md file containing task descriptions, verification commands, and standardized commit messages.

Do I need a bug analysis artifact before generating a TDD task plan?

Yes, you need a completed bug analysis artifact before generating a TDD task plan. This Skill requires an existing root cause analysis on a bug branch to decompose the work into regression-first tasks and output the plan.md document.

Can I use this task planning approach for small to medium maintenance work?

Yes, you can use this task planning approach for small to medium maintenance work. It is designed for routine bug fixes and enforcing reproducible, reviewable change sets on a bug branch by applying regression-first TDD methodology.

Where does the generated TDD bugfix plan file get saved?

The generated TDD bugfix plan file gets saved to work/bugs/RAISE-{N}/plan.md. This file contains per-task descriptions, verification commands sourced from the manifest, and standardized commit messages for implementing the fix.