---
name: debug-plan
description: Create a systematic debugging plan for a bug report. Use when the user asks how to investigate a failure, regression, or unexpected behavior.
title: debug-plan
canonical_url: https://skilld.dev/gh/cloudflare/agents/debug-plan
last_updated: 2026-09-24T00:09:56.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [references/checklist.md](https://skilld.dev/api/skills-raw/cloudflare/agents/debug-plan/references/checklist.md).
>
> If the user asked to install this Skill, run `npx skilld install cloudflare/agents/debug-plan`. Install writes the Skill files into the project, so every session loads them.

# 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`.