~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.