bug-log

Tracks bug fix attempts in centralized Markdown logs to prevent repeating failed approaches across sessions.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/manhthien2005/PM_REVIEW --skill bug-log-manhthien2005
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bug-log
Source: https://github.com/manhthien2005/PM_REVIEW/tree/main/tooling/.windsurf-template/shared/skills/bug-log
Command: npx skills add https://github.com/manhthien2005/PM_REVIEW --skill bug-log-manhthien2005

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI sessions have no memory of prior debugging attempts, so the same failed fixes get proposed again and again. This Skill maintains a persistent, per-bug log file so every hypothesis, attempt, and result is recorded and checked before any new fix is proposed. ## Core Features & Use Cases - Anti-Loop Enforcement: Requires reading the existing bug log before proposing any fix; approaches marked as failed are off-limits without explicit user override. - Structured Bug Records: Provides a template capturing symptom, repro steps, environment, hypothesis log, per-attempt entries, and resolution details, plus a central INDEX.md tracking open and resolved bugs. - Cross-Repo Bug IDs: Uses a sequential ID convention (e.g., HG-001, XR-002) with repo prefixes for HealthGuard, health_system, IoT simulator, and cross-repo bugs. - Use Case: A token refresh bug in the admin web app resurfaces in a new session. The AI reads HG-001.md, sees two failed attempts with documented reasons, and proposes a genuinely different approach instead of looping. ## Quick Start Ask the AI to check the bug log for the current issue in PM_REVIEW/BUGS before proposing any fix, and to record each new attempt with its result.

Frequently Asked Questions about bug-log

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent AI from repeating failed bug fixes across sessions?▼

Maintain a persistent bug log file that records every attempted fix with its result and failure reason. Before proposing any new fix, the AI must read the log and avoid approaches already marked as failed.

How do I structure a bug investigation log in Markdown?▼

Include sections for symptom, reproduction steps, environment, a hypothesis table, and per-attempt entries recording hypothesis, approach, files touched, verification, and result. Close with a resolution section noting the fix commit and regression signals.

When should I create a bug log versus fixing directly?▼

Create a log for non-trivial bugs expected to span multiple sessions, cross-repo bugs, or bugs with unclear root causes. Skip it for trivial single-line fixes or bugs resolved within one session.

What should I do after three failed fix attempts on the same bug?▼

Stop and switch to a stuck workflow: re-read the entire log, map all tried approaches, and question whether the symptom points to an upstream root cause. Discuss with the user before attempting a fourth fix.

Can bug logs contain sensitive data from a medical app?▼

No. Symptoms and log excerpts must redact PHI such as emails, names, and raw vital signs before being recorded. This is an explicit anti-pattern in the logging rules.