grimoire-bug

Reproduce reported bugs with failing tests before implementing minimal fixes.

Updated Jan 26, 2025
One-click install
npx skills add https://github.com/jlissner/lissner.io --skill grimoire-bug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grimoire-bug
Source: https://github.com/jlissner/lissner.io/tree/main/.claude/skills/grimoire-bug
Command: npx skills add https://github.com/jlissner/lissner.io --skill grimoire-bug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Disciplined bug fix workflow with reproduction-first methodology. Use when the user reports a bug or defect that needs fixing.

Core Features & Use Cases

  • Reproduce-first workflow to ensure a failing test exists before coding
  • Structured guidance from triage to fix verification
  • Use case: when a user reports a defect, you reproduce, write a test, implement a minimal fix

Quick Start

Reproduce the bug with a failing test before making any code changes.

Frequently Asked Questions about grimoire-bug

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

FAQPage Schema
How do I reproduce a reported bug before writing a fix?

To reproduce a bug, you identify the reported defect and create a verifiable failing test scenario that anchors the fix. This workflow guides evidence gathering and test creation to ensure the failure is consistently reproducible before making any code changes.

Why should I write a failing test before fixing a bug?

Writing a failing test before fixing a bug ensures the reported defect is verifiable and reproducible. This reproduction-first methodology anchors the code changes in a disciplined process, preventing speculative fixes and confirming the exact failure scenario is addressed.

What is the best way to structure a debugging workflow for a reported defect?

The best way to structure a debugging workflow is through a reproduction-first methodology that moves from triage to fix verification. You reproduce the bug, write a failing test, implement a minimal validated fix, and document the remediation steps for testers.

How do I create a minimal fix without introducing new defects?

To create a minimal fix, you enforce a failing test before writing any code changes and validate the fix within a disciplined workflow. This methodology ensures the remediation directly targets the reproduced failure scenario and prevents unintended regressions.

When do I need a reproduction-first workflow for bug fixing?

You need a reproduction-first workflow when a user reports a bug or defect that requires fixing. This process enforces test creation and evidence gathering upfront to anchor the code remediation in a verifiable and documented failure scenario.

Does this bug reproduction workflow document the fix for testers?

Yes, the bug reproduction workflow documents the remediation steps for testers. After enforcing a failing test and implementing a minimal validated fix, the process outputs structured documentation detailing the verification of the resolved defect.