What is the 'reproduce-first' principle?

It is a core requirement of the WF3 workflow where a failing test capturing the specific bug must be written and verified before any fix code is implemented.

When should I use /fix-bug instead of BMAD tools?

Use /fix-bug for standard rawgentic projects. If your project uses Big Model Architecture Design (BMAD) story files, you should use bmad-dev-story instead.

How does the Root Cause Analysis (RCA) step help?

RCA ensures that the underlying logic error is identified rather than just fixing the symptoms, which significantly reduces the risk of future regressions.

Can this skill run automatically without user input?

Yes, it includes a headless-interaction protocol that can post questions to GitHub issues and suspend execution until a user replies, allowing for asynchronous automation.

Rawgentic Bug Fix Workflow

Name: Rawgentic Bug Fix Workflow
Author: 3D-Stories

by3D-Stories

•

Security & Testing

Automates bug resolution through a disciplined 14-step workflow featuring root cause analysis and reproduce-first TDD.

The Rawgentic Bug Fix skill implements the WF3 workflow, a streamlined version of the rawgentic quality assurance framework optimized for rapid yet rigorous bug resolution. It enforces a 'reproduce-first' principle, requiring a failing test to exist before any code is modified, which ensures every fix is verifiable and grounded in evidence. The workflow guides Claude through analysis, branch creation, Test-Driven Development (TDD), and mandatory code reviews, culminating in a standardized pull request to maintain a clear audit trail for production-grade software projects.

Key Features

01Strict 14-step quality assurance workflow (WF3)

02Reproduce-first TDD to ensure bug verification

03Automated branch management and conventional commit PRs

042 GitHub stars

05Mandatory Root Cause Analysis (RCA) to prevent regressions

06Headless mode support for asynchronous GitHub interactions

Use Cases

01Resolving complex production bugs with a structured audit trail

02Standardizing bug-fixing procedures across a development team

03Automating issue resolution via headless CI/CD integrations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add 3d-stories/rawgentic fix-bug

For use in Claude.ai and ChatGPT