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.