# Debug+

> Invoke when debugging, fixing bugs, diagnosing failures, or when something is broken, unexpected, or not working as expected. Trigger phrases: 'debug', 'fix bug', 'why is X failing', 'what's wrong with', 'broken', 'diagnose', 'investigate'. Wraps superpowers:systematic-debugging with mandatory scout context harvesting.

- **Type:** Skill
- **Install:** `agentstack add skill-franklywatson-claude-rig-debug-plus`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [franklywatson](https://agentstack.voostack.com/s/franklywatson)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [franklywatson](https://github.com/franklywatson)
- **Source:** https://github.com/franklywatson/claude-rig/tree/master/templates/skills/debug-plus

## Install

```sh
agentstack add skill-franklywatson-claude-rig-debug-plus
```

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

## About

# debug+ — Systematic Debugging with Scout Context

Wraps `superpowers:systematic-debugging`. Requires superpowers to be installed.

No phase prerequisite — invoke from any skill chain phase when you encounter a
bug, test failure, or unexpected behavior.

## Before You Begin

This skill adds scout-mandated context harvesting on top of the base debugging skill:

1. **Scout context** — always map the affected code area via the scout agent before debugging
2. **Environment awareness** — detects test infrastructure, dependencies, and recent changes
3. **Constitutional awareness** — loads active enforcement rules from session context

## Procedure

### Phase A: Harvest Context

1. Reproduce the issue — run the failing command or test and capture the exact output.

2. Invoke the scout agent to map the affected area:

   ```
   Agent(subagent_type="scout", prompt="Map the codebase around [affected files/modules]. Focus on: related functions, callers, test files, and recent changes.")
   ```

3. Identify:
   - The exact failure symptom (error message, wrong output, crash)
   - The code path that produces the symptom
   - Recent changes that may have introduced the issue
   - Related test coverage
   - Active enforcement rules from session context (see session-start output)

### Phase B: Investigate (delegate to superpowers:systematic-debugging)

1. Invoke `superpowers:systematic-debugging` with the gathered context.

2. Follow the systematic debugging process:
   - State the hypothesis before investigating
   - Verify the hypothesis with evidence (command output, file reads)
   - If the hypothesis is wrong, state why and form a new one
   - Show the evidence at each step

### Phase C: Report Findings

1. Produce a finding summary:

   ```
   ## Investigation Report

   ### Symptom
   [Exact failure description]

   ### Root Cause
   [What caused the issue]

   ### Evidence
   - [Evidence 1: command output or file content]
   - [Evidence 2: ...]

   ### Fix
   [Specific change needed to resolve the issue]
   ```

2. If the fix is straightforward, implement it and run the relevant tests.
   If the fix requires a larger change, return to the current phase with the finding.

## Skill Chain

`/debug+` has no phase prerequisite — invoke it from any phase when you need to
debug a bug or investigate unexpected behavior. After resolving the
investigation, return to your current phase.

## Completion

Report one of these states when the skill finishes:

- **DONE** — Root cause identified and fix applied with passing tests.
- **DONE_WITH_CONCERNS** — Root cause identified but fix has side effects or needs review.
- **BLOCKED** — Cannot reproduce the issue or insufficient context to diagnose.
- **NEEDS_CONTEXT** — Need user input to reproduce the issue or understand expected behavior.

## Source & license

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

- **Author:** [franklywatson](https://github.com/franklywatson)
- **Source:** [franklywatson/claude-rig](https://github.com/franklywatson/claude-rig)
- **License:** MIT

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-franklywatson-claude-rig-debug-plus
- Seller: https://agentstack.voostack.com/s/franklywatson
- 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%.