fix-bug

Automate a six-phase bug-fix workflow from reproduction to recording.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/SamyakJhaveri/loam --skill fix-bug-samyakjhaveri
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-bug
Source: https://github.com/SamyakJhaveri/loam/tree/main/seed/.claude/skills/fix-bug
Command: npx skills add https://github.com/SamyakJhaveri/loam --skill fix-bug-samyakjhaveri

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bug fixes often spiral into disorganization without a repeatable process. This Skill enforces a reproduction-first workflow with six phases (reproduce, diagnose, plan, fix, verify, record) and an enforced gate at exit to ensure quality and traceability.

Core Features & Use Cases

  • Reproduce failures quickly by gathering exact error output and setting a deterministic signal.
  • Diagnose in parallel with structured planning to draft minimal, verifiable fixes.
  • Plan, implement, and verify changes, then record outcomes and update known-issues.
  • Use Case: when a test fails or a build step fails, guiding engineers to a safe, auditable fix process.

Quick Start

Initiate the bug-fix workflow by selecting a failing test or build, then follow the six-phase process.

Frequently Asked Questions about fix-bug

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

FAQPage Schema
How do I debug a failing build or flaky test using a structured workflow?

A structured bug fix workflow enforces a six-phase cycle: reproduce the failure, diagnose the cause, plan the fix, implement changes, verify with a deterministic feedback loop, and record the outcome for traceability.

What is the best way to reproduce unexpected behavior across different test specs?

Reproduce unexpected behavior by gathering the exact error output and establishing a deterministic signal. A reproduction-first workflow ensures a reliable failure state before diagnosing or planning any code changes.

Do I need clear reproduction steps before I can diagnose and fix a bug?

Yes, clear reproduction steps are required. The bug fix workflow mandates a deterministic feedback loop and exact reproduction of the failing build or flaky test before moving to diagnosis, planning, and implementation phases.

Can I validate a bug fix plan before implementing the actual code changes?

Yes, you can validate a plan before implementing changes. The workflow includes a dedicated planning phase for drafting minimal fixes and integrates with a validation gate to ensure the plan is safe before execution.

What should I do if my debugging process becomes disorganized and spirals out of control?

If your debugging process spirals, enforce a repeatable six-phase workflow: reproduce, diagnose, plan, fix, verify, and record. An enforced exit gate ensures quality and traceability, eliminating disorganized bug fixes.