~aod-bugfix

Guide engineers through five-why root-cause analysis and gated bug-fix workflows.

86|21|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/davidmatousek/tachi --skill aod-bugfix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ~aod-bugfix
Source: https://github.com/davidmatousek/tachi/tree/main/.claude/skills/~aod-bugfix
Command: npx skills add https://github.com/davidmatousek/tachi --skill aod-bugfix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnosing and repairing bugs is often slow and error-prone. This Skill provides a repeatable, five-why based root-cause analysis and a guarded workflow that ensures changes are intentionally applied and documented.

Core Features & Use Cases

  • Five-Whys Root Cause Analysis: guides the team to the true cause rather than superficial symptoms.
  • Phase-Gated Fix Workflow: diagnose → plan → implement → verify → document with a non-deferrable confirmation gate before edits.
  • KB Documentation: automatically generates a knowledge-entry draft for post-mortems and future prevention.
  • Use Case: for a failing test, a user-reported bug, or intermittent issue, the workflow yields a recorded root cause and a validated fix plan.

Quick Start

Paste a bug report or failing test output and let the workflow guide you through diagnosis, planning, implementation, verification, and documentation.

Frequently Asked Questions about ~aod-bugfix

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

FAQPage Schema
How do I perform a root-cause analysis for a failing test?

Root-cause analysis for a failing test is performed using a guided five-why methodology to identify the true cause rather than superficial symptoms. This structured approach ensures accurate diagnosis before proceeding to implementation.

What is the phase-gate process for applying a bugfix?

The phase-gate process for a bugfix enforces a non-deferrable confirmation gate before any code edits are applied. It follows a structured workflow: diagnose, plan, implement, verify, and document, ensuring changes are intentional and validated.

How do I document a bugfix for future prevention?

Documenting a bugfix for future prevention is handled by automatically generating a knowledge-base entry draft. This creates a post-mortem record from your five-why root-cause statement and verified fix plan for future reference.

Can I fix intermittent user-reported bugs without missing underlying issues?

Intermittent user-reported bugs can be fixed without missing underlying issues by applying a repeatable five-why root-cause analysis. This workflow ensures you record the true cause and validate the fix plan before implementation.

What is the best way to prevent superficial fixes when debugging?

The best way to prevent superficial fixes when debugging is using a guarded workflow with a confirmation gate before edits. This enforces a structured five-why diagnosis and planning phase to address the true root cause.