debug is an archived example, not installed by init. Copy it from examples/init-pack/ with its dependency closure, or ask create-workflow to build an equivalent.
debug reuses implement’s ValidationLoop component with a bug-focused default prompt, but skips early-exit (done) and prior-attempt feedback, so it always runs all maxIterations (up to 3) instead of stopping once validation passes and a reviewer approves.
The debug UI shows the reproduce → fix → validate iterations, with no early exit until the fix is verified.
Inputs
How It Runs
- Reproduces the bug.
- Applies a targeted fix.
- Validates the result.
- Reviews the fix, repeating the implement/validate/review cycle via
ValidationLoopfor allmaxIterations(up to 3).
improve-test-coverage for a regression test, then review to confirm production-readiness.
Output Shape
debug commits changes directly to the working tree. The run log records each iteration’s validation result and reviewer feedback; the last iteration’s output is the final result.
Use it when
- A reported bug needs reproduction, a fix, and validation.
- You want every iteration to run rather than stopping at the first green check.
Use something else when
- You already know the fix and just want it applied and reviewed: use
implement. - You need a regression test for the fix: follow with
improve-test-coverage.
Resume & retry
Runs are durable and resume withup --resume.