Converted and distributed by TomeVault — claim your Tome and manage your conversions.
Coder Rules Debug Requirements
Debugging requirements protocol from reproducible issue to verified fix and regression protection. Use when this capability is needed.
tomevault-io Updated
Coder Rules Debug Requirements by tomevault-io · 5265966
npx get-skill add tomevault-io/coder-rules-debug-requirements File contents
---name: coder-rules-debug-requirementsdescription: Debugging requirements protocol from reproducible issue to verified fix and regression protection. Use when this capability is needed.---<when_to_use> <trigger>Investigating functional bugs, crashes, regressions, or production incidents</trigger> <trigger>Need structured debug flow for coding agent execution</trigger> <trigger>Need explicit completion criteria for bug fixes</trigger></when_to_use><input_requirements> <required>Symptom statement and impact</required> <required>Expected vs actual behavior</required> <required>Minimal reproducible example (steps/data)</required> <required>Environment fingerprint (version, config, flags)</required> <required>Evidence pack (errors, logs, traces, timestamps)</required></input_requirements><debug_workflow> <step>Triage impact and confirm current reproducibility</step> <step>Build minimal reproducible case</step> <step>Localize failing layer and narrow search space</step> <step>State testable hypothesis and instrumentation plan</step> <step>Apply minimal root-cause fix</step> <step>Verify fix against acceptance criteria</step> <step>Add regression test/eval that fails before and passes after</step> <step>Record residual risks and follow-up actions</step></debug_workflow><quality_rules> <rule importance="critical">No reproducible signal means no claim of confirmed fix</rule> <rule importance="critical">Bugfix is incomplete without regression protection</rule> <rule importance="high">Fix must target root cause, not only symptom masking</rule> <rule importance="high">Verification must include evidence from commands or telemetry</rule></quality_rules><required_signals> <signal>Repro rate before and after fix</signal> <signal>Error rate or failure count change</signal> <signal>Latency/perf guardrail impact when relevant</signal> <signal>Regression suite result for affected path</signal></required_signals><do_not> <item importance="critical">Do not debug by guesswork without hypothesis</item> <item importance="critical">Do not close issue without reproducible verification</item> <item importance="high">Do not skip regression test because fix "looks obvious"</item> <item importance="high">Do not merge broad refactor as hidden hotfix</item></do_not><output_requirements> <requirement>Problem statement with expected vs actual</requirement> <requirement>Root cause summary and impacted components</requirement> <requirement>Fix summary with evidence of verification</requirement> <requirement>Regression artifact added and location</requirement></output_requirements><references> <source url="https://stackoverflow.com/help/minimal-reproducible-example">Stack Overflow MRE Guide</source> <source url="https://web.mit.edu/6.005/www/fa15/classes/11-debugging/">MIT Debugging Workflow</source> <source url="https://platform.openai.com/docs/guides/evaluation-best-practices">OpenAI Evaluation Best Practices</source> <source url="https://platform.openai.com/docs/guides/evals">OpenAI Evals Guide</source> <source url="https://www.anthropic.com/engineering/demystifying-evals-for-ai-agents">Anthropic: Demystifying Evals for AI Agents</source> <source url="https://sre.google/sre-book/postmortem-culture/">Google SRE Postmortem Culture</source> <source url="https://opentelemetry.io/docs/concepts/context-propagation/">OpenTelemetry Context Propagation</source></references>---> Converted and distributed by [TomeVault](https://tomevault.io/claim/ozerohax) — claim your Tome and manage your conversions.<!-- tomevault:4.0:skill_md:2026-04-11 -->
tomevault-io/skills-registry/tree/main/ozerohax--assistagents--debug-requirements commit 5265966feb
Frequently asked questions
Run npx get-skill add tomevault-io/coder-rules-debug-requirements in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Debugging requirements protocol from reproducible issue to verified fix and regression protection. Use when this capability is needed. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.