---
title: "debug-root-cause"
description: "Debug with method, not guesses: reproduce and isolate the failure, gather evidence, run a hypothesis ledger with minimal experiments, fix the root cause behind a failing test, verify green, and write a short bug report, "
canonical: https://agentpluginsdirectory.com/plugins/debug-root-cause
last-updated: 2026-09-27
---

# debug-root-cause
Debug with method, not guesses: reproduce and isolate the failure, gather evidence, run a hypothesis ledger with minimal experiments, fix the root cause behind a failing test, verify green, and write a short bug report, for any concrete test, build, CI, or runtime failure.
- Slug: debug-root-cause
- Publisher: AgentRelay Maintainers
- Repository: https://github.com/trisjr/agent-relay
- Manifest: plugins/debug-root-cause/plugin.json
- Version: 0.1.0
- Category (editorial): other
- Skills: 1 (debug-root-cause)
- MCP servers: 0
- Stars: 0
- Repository created: 2026-09-25
- Repository last pushed: 2026-09-27
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/debug-root-cause
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What debug-root-cause does, in the publisher's words

Plugin giúp agent điều tra một lỗi đang xảy ra theo bằng chứng: tái hiện và cô lập lỗi, thu thập dữ liệu, kiểm tra giả thuyết bằng thí nghiệm nhỏ, sửa nguyên nhân gốc sau khi có test đỏ, xác minh test và suite liên quan xanh, rồi viết bug report ngắn. Áp dụng cho test, build, CI hoặc runtime failure cụ thể.

- systematic-debugging của superpowers (MIT) là prior art gần nhất. Skill này bổ sung tiêu chí vào/ra cho từng pha, hypothesis ledger có mẫu và cách xếp hạng giả thuyết, nhánh riêng cho lỗi chập chờn hoặc chỉ xảy ra trên CI, điều kiện escalation cho hạ tầng/vendor, và bước Aftermath.
- The Debugging Book của Andreas Zeller (CC BY-NC-SA) gợi cấu trúc kiểm chứng từ test case đến giả thuyết, quan sát và test hồi quy; plugin chỉ kế thừa cấu trúc, không trích văn bản.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/trisjr/agent-relay/HEAD/plugins/debug-root-cause/README.md

## Skills

- debug-root-cause: Debug a concrete, existing failure with method instead of guesses, reproduce and isolate it, gather evidence from logs, traces, diffs and environment, run a hypothesis ledger with the smallest possible experiments, fix the root cause only after a failing test proves it ("red"), verify the fix turns…

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.