vibe-debugging-journal

A persistent journal for recording resolved software bugs. It stores the symptom, root cause, fix, difficulty, prevention, category, and affected files.

In plain words
What is it for?
Use it after resolving non-trivial, hard-to-reproduce, or recurring bugs, especially those involving concurrency, state, validation, integrations, environments, or interface rendering.
Why use it?
It helps preserve explanations for difficult or surprising bugs so the same investigation does not have to be repeated later.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/mracal/vibe-engineering/debugging-journal
Any agent
npx skills add mracal/vibe-engineering --skill debugging-journal
Clone the repo
git clone --depth 1 https://github.com/mracal/vibe-engineering

Made for: Claude Code, Codex.

Per session 33 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 418 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00033 $0.00418
Opus 5 $0.00016 $0.00209
Sonnet 5 $0.00007 $0.00084
Haiku 4.5 $0.00003 $0.00042

Measured 3d ago against content hash 01cc7039f08a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

vibe-debugging-journal scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to vibe-debugging-journal — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/debugging-journal/SKILL.md · 56 lines

What it actually says

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]
  1. Save to persistent storage:

    • Project: docs/debugging-journal.md or DEBUGGING.md
    • Memory: Claude auto-memory or MCP
  2. 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).

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 56 lines · 33 tokens per session scan A 01cc7039f08a

Subscribe to this mod's changes

vibe-debugging-journal is a skill published in the GitHub repository mracal/vibe-engineering (3 stars, last pushed 3d ago), licensed MIT. It adds 33 tokens to every session and 418 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to vibe-debugging-journal, differing in 0 lines, and is treated as a copy.

Related

Other skills, from other repositories

codexkit-repository-maintenance

Use when maintaining or improving the GameStudio-CodexKIT source repository, including CI, governance, catalog, generators, adapters, packaging, documentation, versioning, or release readiness.

hoatv2211/GameStudio-CodexKIT · 45 tokens

unity-ui-art-and-motion-production

Use when new or revised Unity UI visuals, icons, panels, 9-slice sprites, component states, HUD or menu layouts, popup motion, screen transitions, or flattened UI screenshot decomposition must be produced through Figma and integrated into uGUI, NGUI, or UI Toolkit; not for UI debugging, localization-only work…

hoatv2211/GameStudio-CodexKIT · 83 tokens

game-screenshot-showcase-and-store-packaging

Use when a Unity team needs approved PlayMode screenshots, immutable capture evidence, reviewed showcase slides, or report-only store screenshot packaging without auto-upload, signing, or submission.

hoatv2211/GameStudio-CodexKIT · 44 tokens

studio-project-scaffold

Use when running gamestudio init, status, or uninit, or bootstrapping a new or adopted game repository with AGENTS.md, HANDOFF.md, .agents/CONTRACT.md, project governance, a subsystem registry, or a per-project adapter report, plan digest, named reviewer, backup root, generated agent overlay, apply, uninstall, and…

hoatv2211/GameStudio-CodexKIT · 85 tokens

using-game-studio-skills

Use when starting any GameStudio-CodexKIT task or when a model runner is unavailable and someone requests a confidence-based PASS.

hoatv2211/GameStudio-CodexKIT · 33 tokens

evidence-first-debugging

Use when debugging a crash, lỗi, failing game, tool, build, service, script, or reproducible local code failure requires repro or reproduction, giả thuyết or ranked hypotheses, instrumentation, root-cause isolation, a minimal fix, regression proof, and a regression test.

hoatv2211/GameStudio-CodexKIT · 63 tokens