fix-bug

Diagnose and fix logic bugs by locating failure layers and verifying root causes.

16|3|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/YehudaFrankel/clankbrain --skill fix-bug-yehudafrankel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-bug
Source: https://github.com/YehudaFrankel/clankbrain/tree/main/.claude/skills/fix-bug
Command: npx skills add https://github.com/YehudaFrankel/clankbrain --skill fix-bug-yehudafrankel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you diagnose and fix logic bugs in software by guiding you through failure analysis and corrective steps.

Core Features & Use Cases

  • Locate the failure layer (frontend, API/backend, database, scheduler, or email) and identify where behavior diverges from expectation.
  • Read relevant files to verify the root cause before making changes.
  • Hypothesize root causes, validate fixes, and verify restoration of expected behavior.
  • Log changes and report outcomes to maintain a traceable fix history.
  • Use auto-chain to run verification and guard steps after every fix to prevent regressions.

Quick Start

Describe the bug scenario and let the skill guide you through failure-layer identification, root-cause hypothesis, and a safe fix.

Frequently Asked Questions about fix-bug

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

FAQPage Schema
How do I diagnose and fix logic bugs across multiple software layers?

Debugging silent failures requires isolating the specific layer where behavior diverges from expectations. You identify whether the failure is in the frontend, API/backend, database, scheduler, or email layer, then read the relevant files to verify the root cause.

How do I verify a bug fix and prevent regressions in my codebase?

To verify a bug fix and prevent regressions, you run auto-chain verification and guard steps after applying corrections. This validates the restoration of expected behavior and logs changes to maintain a traceable fix history for future maintenance.

What is the best way to find the root cause of a silent failure during maintenance?

Finding the root cause of a silent failure involves locating the failure layer, reading relevant files, and hypothesizing root causes before making changes. This enforces a structured root-cause analysis to verify the actual source of the divergence.

Does this bug diagnosis process work for both frontend and database layers?

Yes, this bug diagnosis process works for frontend, API/backend, database, scheduler, and email layers. It applies to codebases with multiple layers by guiding failure-layer identification and corrective steps across the entire stack.

How do I maintain a traceable fix history when correcting software bugs?

To maintain a traceable fix history when correcting software bugs, you log changes and report outcomes after verifying fixes. This records the root-cause hypothesis and validation steps, ensuring future maintenance has full context.