Development
x-diagnose
Disciplined bug/performance diagnosis loop for a single session. Use when debugging hard failures, regressions, or unexplained behavior.
Fromlan · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add Fromlan/X-agent --skill x-diagnoseAbout this skill
name: x-diagnose description: Disciplined bug/performance diagnosis loop for a single session. Use when debugging hard failures, regressions, or unexplained behavior.
Diagnose
Stay in one session. Do not spawn background agents.
Loop
- Reproduce — Steps, expected vs actual, environment (cwd, OS, relevant tools).
- Minimise — Smallest path that still fails (file, scene, input).
- Hypothesise — 1–3 ranked causes; pick the cheapest to falsify first.
- Instrument — Add temporary logs/asserts or read existing signals; remove noise after.
- Fix — Smallest change that addresses the confirmed cause.
- Regression — Re-run the reproduce path; add or adjust a test if the project has a test harness.
Anti-patterns
- Shotgun edits across unrelated files before a confirmed cause.
- Claiming “fixed” without re-running the failing path.