debug-with-file

Installation
SKILL.md

Codex Debug-With-File Prompt

Overview

Enhanced evidence-based debugging with documented exploration process. Records understanding evolution, consolidates insights, and uses analysis to correct misunderstandings.

Core workflow: Explore → Document → Log → Analyze → Correct Understanding → Fix → Verify

Key enhancements over /prompts:debug:

  • understanding.md: Timeline of exploration and learning
  • Analysis-assisted correction: Validates and corrects hypotheses
  • Consolidation: Simplifies proven-wrong understanding to avoid clutter
  • Learning retention: Preserves what was learned, even from failed attempts

Target Bug

$BUG

Project Context

Installs
75
GitHub Stars
2.1K
First Seen
Feb 5, 2026
debug-with-file — catlog22/claude-code-workflow