# Debug Plan

> Debug Plan is an Agent Skill for testing & quality published in the cloudflare/agents repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Create a systematic debugging plan for a bug report. Use when the user asks how to investigate a failure, regression, or unexpected behavior.

- Skill name: `debug-plan`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/cloudflare/agents/blob/HEAD/examples/agent-skills/src/skills/debug-plan/SKILL.md
- Repository: cloudflare/agents (5,274 GitHub stars when collected)

## SKILL.md

# Debug Plan

Create a practical debugging plan that starts with evidence before fixes.

## Instructions

1. Restate the symptom in one sentence.
2. List the most likely failure boundaries.
3. Suggest the first three checks in order.
4. Identify what evidence would confirm or reject each hypothesis.
5. End with the smallest safe fix path.

Keep the plan short enough that someone can start immediately.

For more detail on the shape of the output, read
`references/checklist.md`.

---

Source: https://www.openparable.com/skill/testing-quality/debug-plan (OpenParable). Cite the canonical URL above.
