Menu
Initialize bug branch, reproduce, and create scope artifact. Phase 1 of bugfix pipeline.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | rai-bugfix-start |
| description | Initialize bug branch, reproduce, and create scope artifact. Phase 1 of bugfix pipeline. |
| allowed-tools | ["Read","Edit","Write","Grep","Glob","Bash(git:*)"] |
| license | MIT |
| metadata | {"raise.adaptable":"true","raise.fase":"1","raise.frequency":"per-bug","raise.gate":"","raise.next":"bugfix-triage","raise.prerequisites":"","raise.skillset":"raise-maintainability","raise.version":"2.4.0","raise.visibility":"public","raise.work_cycle":"bugfix","raise.inputs":"- bug_id: string, required, argument (e.g. RAISE-251)\n- dev_branch: string, required, config\n","raise.outputs":"- bug_branch: string, next_skill\n- scope_md: file_path, next_skill\n"} |
Create a bug branch from the development branch, reproduce the bug, and write the scope artifact that defines what the bug is and when it's fixed.
When to use: A tracked bug (Jira issue) needs formal resolution with branch, artifacts, and traceability.
When to skip: Trivial fix (typo, obvious one-liner) โ commit directly. Already started (scope.md exists).
Inputs: Bug ID (e.g., RAISE-251), problem statement or reproduction steps.
Expected state: On {dev_branch}, up to date with remote. No work/bugs/RAISE-{N}/ directory yet.
Branch config: Read branches.development from .raise/manifest.yaml for {dev_branch}.
git checkout {dev_branch} && git pull origin {dev_branch}
git checkout -b bug/raise-{N}/{bug-slug}
Reproduce the bug โ confirm it is observable. Write work/bugs/RAISE-{N}/scope.md:
WHAT: [behavior observed]
WHEN: [conditions / triggers]
WHERE: [file:line or component]
EXPECTED: [correct behavior]
Done when: [specific observable outcome]
Commit the scope artifact:
git add work/bugs/RAISE-{N}/scope.md
git commit -m "bug(RAISE-{N}): initialize scope
WHAT: {summary}
Done when: {criteria}
Co-Authored-By: Rai <rai@humansys.ai>"
| Item | Destination |
|---|---|
| Bug branch | bug/raise-{N}/{slug} from {dev_branch} |
| Scope artifact | work/bugs/RAISE-{N}/scope.md |
| Next | /rai-bugfix-triage |
{dev_branch}/rai-bugfix-triage/rai-bugfix-closeCLAUDE.md ยง Branch ModelInteractive adapter setup for Jira and Confluence. Detects available backends, discovers projects/spaces, generates validated YAML config. 3-4 questions max.
Evaluate design proportionality using Beck's four rules. Use after implementation.
Root cause analysis using the method best suited to the bug. Phase 3 of bugfix pipeline.
Push branch, create MR, verify artifacts complete. Phase 7 of bugfix pipeline.
Execute fix tasks with TDD and all validation gates. Phase 5 of bugfix pipeline.
Decompose fix into atomic TDD tasks. Phase 4 of bugfix pipeline.