Diagnose bugs through a reproducible loop of reproduction, hypothesis, instrumentation, fix, and regression testing.
npx skills add https://github.com/yamcodes/arkenv --skill diagnose-yamcodes
Please help me install this Agent Skill. Skill: diagnose Source: https://github.com/yamcodes/arkenv/tree/main/skills/diagnose Command: npx skills add https://github.com/yamcodes/arkenv --skill diagnose-yamcodes
Diagnoses hard bugs and performance regressions by enforcing a disciplined, repeatable diagnostic loop that moves from reproduction to regression testing.
Run the hitl-loop.template.sh script inside skills/diagnose/scripts to start the interactive diagnostic loop.
High-intent search queries and answers about installing and using this skill.
To debug a hard bug, you follow a disciplined diagnosis loop that reproduces, minimises, hypothesises, instruments, fixes, and regression-tests the issue. This structured approach ensures reproducible debugging across codebases.
The best way to structure bug triage is using a phase-based workflow: reproduce, hypothesise, instrument, fix, and regression-test. This enforces a repeatable diagnostic loop for resolving complex regressions.
You use instrumentation during the hypothesis phase of the diagnostic loop to gather data on a user-reported error. A human-in-the-loop script template guides reproducible experiments to isolate the fault.
Yes, you can apply this structured reproduction loop to any codebase. It guides debugging through tests, instrumentation, and structured hypotheses to accurately address bugs and regressions.
You need domain glossaries and ADRs during debugging to maintain consistent mental models during investigation. They provide context and architectural decisions to ensure accurate diagnosis across complex codebases.
Ad hoc debugging lacks a regression-testing phase and structured hypotheses, making it prone to incomplete fixes. A disciplined diagnostic loop enforces reproduction and instrumentation to prevent recurring regressions.
gilesknapGuide debugging from reproduction through regression testing for software issues.
DYAI2025Generate Arrange-Act-Assert regression tests for Jest, Vitest, pytest, or Playwright.
riethmayerDiagnose hard bugs through a six-phase reproduction-to-regression-check loop.
subroh0508Analyze bug reports into reproduction steps, root-cause findings, and specification-gap assessments.
