Systematic Debugging

SkillDev tools

4-phase root cause process before any fix. Use whenever you encounter an error.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Systematic Debugging skill

What this skill tells your AI

The instructions your AI receives, as published by archieindian/openclaw-superpowers in skills/core/systematic-debugging/SKILL.md and read by ahel’s review.

Never guess at fixes. Find the root cause first.

Phase 1: Understand the Error

  • Read the full error message
  • Note the exact file, line, error type
  • Reproduce the error reliably
  • Write: 'The error is: [exact error] at [location] when [trigger].'

Phase 2: Hypothesize

Generate at least 2 hypotheses. For each: what evidence supports it? What would disprove it?

Phase 3: Test Hypotheses

Test each hypothesis with the minimum change to confirm or deny it.

  • Add a log line, not a fix
  • Test one variable at a time

Phase 4: Fix and Verify

  1. Write the fix
  2. Verify the original error is gone
  3. Verify no new errors
  4. Add a test that would have caught this bug

Signals

GitHub stars
72
Forks
14
Last commit
May 2026
Advanced
Item type
skill
Key
systematic-debugging-archieindian
Source
github.com/archieindian/openclaw-superpowers