# Vibe Debugging Journal

> Records resolved bugs in a persistent journal — symptom, root cause, difficulty, fix, prevention. Organized by category for future reference.

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

## Install

```sh
agentstack add skill-ash1794-vibe-engineering-debugging-journal
```

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

## About

# vibe-debugging-journal

Bugs come in patterns. Recording them prevents re-investigation.

## When to Use This Skill

- After resolving a non-trivial bug (took >10 minutes to find)
- After finding a bug that was hard to reproduce
- After debugging something where the root cause was surprising
- When you notice a bug pattern repeating

## When NOT to Use This Skill

- Trivial bugs (typos, missing imports)
- Bugs with immediately obvious causes
- Build/configuration issues (not really bugs)

## Steps

1. **Categorize** the bug:
   - Concurrency (race conditions, deadlocks, ordering)
   - State Management (stale state, missing updates, cache invalidation)
   - Type/Validation (type errors, missing validation, edge cases)
   - Integration (API mismatch, version incompatibility, protocol errors)
   - Environment (platform-specific, config, deployment)
   - UI/Rendering (layout, hooks, lifecycle)

2. **Record** in structured format:

```
### [Category]: [Short description]
**Date**: [date]
**Symptom**: [What was observed]
**Root Cause**: [The actual problem]
**Why Hard to Find**: [What made debugging difficult]
**Fix**: [What was changed]
**Prevention**: [How to prevent recurrence]
**Files**: [affected files]
```

3. **Save** to persistent storage:
   - Project: `docs/debugging-journal.md` or `DEBUGGING.md`
   - Memory: Claude auto-memory or MCP

4. **Cross-reference** — If this relates to an existing journal entry, link them

## Output Format

Present the entry for user confirmation, then save. Keep entries concise (5-10 lines each).

## Source & license

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

- **Author:** [ash1794](https://github.com/ash1794)
- **Source:** [ash1794/vibe-engineering](https://github.com/ash1794/vibe-engineering)
- **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-ash1794-vibe-engineering-debugging-journal
- Seller: https://agentstack.voostack.com/s/ash1794
- 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%.