# 08 Debug

> Reproduce and fix bugs systematically using test-driven workflow, root cause analysis, and hypothesis validation.

- **Type:** Skill
- **Install:** `agentstack add skill-ai-driven-dev-framework-08-debug`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ai-driven-dev](https://agentstack.voostack.com/s/ai-driven-dev)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ai-driven-dev](https://github.com/ai-driven-dev)
- **Source:** https://github.com/ai-driven-dev/framework/tree/main/plugins/aidd-dev/skills/08-debug
- **Website:** https://www.ai-driven-dev.fr/

## Install

```sh
agentstack add skill-ai-driven-dev-framework-08-debug
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill: debug

Diagnoses issues through structured hypothesis validation, root cause analysis, and test-driven bug fixing from issue creation to PR.

## Available actions

| #   | Action          | When to use                                                                   |
| --- | --------------- | ----------------------------------------------------------------------------- |
| 01  | `reproduce`     | A known bug must be fixed end to end: reproduce, test-driven fix, branch, PR   |
| 02  | `debug`         | Root cause unknown: enumerate hypotheses, validate each, confirm the cause     |
| 03  | `reflect-issue` | Stuck or prior fixes failed: re-open the search space, instrument logs first   |

## Routing (run first)

This skill offers three distinct actions. Pick the ONE matching the user's intent; do NOT default to action 01.

- "fix this bug", "reproduce and fix", "from issue to PR" -> `01-reproduce`
- "why does this happen", "find the root cause", "debug this", "what's causing X" -> `02-debug`
- "I'm stuck", "previous fixes didn't work", "rethink the causes", "add logs to narrow it down" -> `03-reflect-issue`

If the intent is ambiguous, ask one clarifying question before picking. Then read and follow only the matching action file.

## Actions

- `@actions/01-reproduce.md`
- `@actions/02-debug.md`
- `@actions/03-reflect-issue.md`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ai-driven-dev](https://github.com/ai-driven-dev)
- **Source:** [ai-driven-dev/framework](https://github.com/ai-driven-dev/framework)
- **License:** MIT
- **Homepage:** https://www.ai-driven-dev.fr/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ai-driven-dev-framework-08-debug
- Seller: https://agentstack.voostack.com/s/ai-driven-dev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.