# Debug Investigator

> A Claude skill from codejunkie99/agentic-stack.

- **Type:** Skill
- **Install:** `agentstack add skill-codejunkie99-agentic-stack-debug-investigator`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [codejunkie99](https://agentstack.voostack.com/s/codejunkie99)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [codejunkie99](https://github.com/codejunkie99)
- **Source:** https://github.com/codejunkie99/agentic-stack/tree/master/.agent/skills/debug-investigator

## Install

```sh
agentstack add skill-codejunkie99-agentic-stack-debug-investigator
```

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

## About

# Debug Investigator — systematic, not vibes-based

Follow this loop every time. Jumping straight to "fix" without reproducing
is how false fixes ship.

## The loop
1. **Reproduce.** Get a deterministic failure. If you can't reproduce, you
   can't fix.
2. **Isolate.** Bisect the problem space: narrow inputs, narrow code paths,
   narrow time windows.
3. **Hypothesize.** Form *one* explicit hypothesis. Write it in
   `memory/working/WORKSPACE.md` under "Active hypotheses".
4. **Test the hypothesis.** A single change that proves or disproves it —
   no shotgun fixes.
5. **Verify.** After the fix, re-run the repro. If the bug is gone, the
   repro is your new regression test.

## What to log
- Each hypothesis that was wrong (high importance; these compound into
  domain knowledge).
- The actual root cause and why it wasn't obvious.

## Anti-patterns
- "It works now, not sure why" — keep investigating.
- Adding `try/except` to silence an error without understanding it.
- Changing five things at once and claiming one of them fixed it.

## Self-rewrite hook
If the same class of bug appears 3+ times (timezone bugs, race conditions,
off-by-one), promote a lesson to `LESSONS.md` and update this skill with
a domain-specific sub-procedure.

## Source & license

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

- **Author:** [codejunkie99](https://github.com/codejunkie99)
- **Source:** [codejunkie99/agentic-stack](https://github.com/codejunkie99/agentic-stack)
- **License:** Apache-2.0

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-codejunkie99-agentic-stack-debug-investigator
- Seller: https://agentstack.voostack.com/s/codejunkie99
- 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%.