# Debug Loop > Debug by reproducing, minimizing, writing regression tests, fixing, and documenting. Use when this capability is needed. - Skill: `tomevault-io/debug-loop` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/debug-loop` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/debug-loop/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/debug-loop --- 1) Reproduce the failure (exact command, inputs, environment). 2) Minimize to the smallest failing case. 3) Add a regression test that fails before the fix. 4) Fix the root cause. 5) Re-run the project test command (`codex.toml` `test` if present; otherwise `uv run pytest -q`). 6) Update the feature spec Debug log with repro, root cause, fix, and regression test. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/rafaie) — claim your Tome and manage your conversions.