test-first-bugs

Enforces a test-first bug-fixing workflow with parallel fix attempts and full-suite verification.

359|61|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/jamditis/claude-skills-journalism --skill test-first-bugs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-first-bugs
Source: https://github.com/jamditis/claude-skills-journalism/tree/main/test-first-bugs
Command: npx skills add https://github.com/jamditis/claude-skills-journalism --skill test-first-bugs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps teams enforce a test-first bug-fixing workflow to prevent regressions when bugs are reported.

Core Features & Use Cases

  • Reproduce bugs by writing a failing test that demonstrates the problem.
  • Organize parallel fix attempts using subagents and verify fixes against the specific failing test and the full suite.
  • Provide templates and workflows for documenting bugs, running targeted tests, and reporting success.

Quick Start

Describe a bug in natural language, locate relevant tests, craft a failing reproduction test, run the appropriate test command, and iterate until the test passes and the suite is clean.

Frequently Asked Questions about test-first-bugs

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

FAQPage Schema
What is a test-first bug fix workflow and why use it?

A test-first bug fix workflow means reproducing a reported bug by writing a failing test, then iterating on the fix until the test passes. This prevents regressions by verifying the specific issue is resolved before closing the bug.

How do I fix a bug using test-driven development steps?

To fix a bug, describe it in natural language, locate relevant tests, and craft a failing reproduction test. Run the appropriate test command, iterate your fix until the targeted test passes, and verify the full suite is clean.

Can I use this test-first bug fixing workflow with unittest and pytest?

Yes, the workflow applies across programming languages and project types. It guides locating tests, running targeted test commands, and verifying the full suite, making it compatible with frameworks like pytest and unittest.

What is the best way to organize parallel fix attempts for a bug?

The best way to organize parallel fix attempts is by using subagents. You can run multiple fix strategies simultaneously and verify each against the specific failing test and the full suite to ensure no regressions occur.

Does a test-first bug fixing process work for any programming language?

Yes, the test-first bug fixing process is designed to apply across programming languages and project types. It focuses on the structural process of writing failing tests and verifying fixes rather than language-specific syntax.