rai-bugfix-start

Creates a bug branch, reproduces the issue, and generates a scope.md artifact.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize bug branch, reproduce, and create scope artifact. Phase 1 of bugfix pipeline.

Core Features & Use Cases

  • Bug branch initialization: Create a branch from the development branch for tracked bugs and ensure it is up to date.
  • Bug reproduction & scope generation: Reproduce the issue and generate a scope.md documenting WHAT, WHEN, WHERE, and DONE-when.
  • Artifacts for triage: Produce the initial scope artifact to enable formal triage and handoff.

Quick Start

Run the bugfix-start skill to create a bug branch from development, reproduce the bug, and commit the scope artifact.

Frequently Asked Questions about rai-bugfix-start

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

FAQPage Schema
How do I create a dedicated git bugfix branch and document the issue scope?

This skill automates bugfix branch initialization by creating a dedicated bug branch from the development config, reproducing the issue, and committing a scope.md artifact that documents what, when, where, and done-when criteria for formal triage.

What is a bug reproduction scope artifact and when do I need one?

A bug reproduction scope artifact is a committed scope.md file defining what the bug is, when it occurs, where it manifests, and the done-when resolution criteria. You need one when tracked bugs require formal validation and documentation before investigation continues.

How do I initialize a formal bugfix workflow for tracked software bugs?

You initialize a formal bugfix workflow by reading development branch config, creating a deterministic bug/RAISE-{N} branch, reproducing the issue, and committing the work/bugs/RAISE-{N}/scope.md artifact to enable triage and handoff before further investigation.

Does this bugfix branching approach work with my existing git development branch configuration?

Yes, this approach works with existing git development branch configurations by reading the development branch config deterministically to ensure the newly created bug branch is up to date before reproduction and scope generation begin.

What's the best way to automate bug triage handoff with scope documentation?

The best way to automate bug triage handoff is to generate a scope.md artifact during branch initialization that documents the bug's what, when, where, and done-when conditions, producing formal artifacts ready for downstream triage and team handoff.

Why does my bugfix branch need a reproduction step before investigation continues?

Your bugfix branch needs a reproduction step because formal bugfix pipelines require validation that the issue exists before investigation continues, ensuring the scope artifact accurately documents the problem for triage and downstream resolution work.