/dev-ultraqa

name: dev-ultraqa
description: QA cycling workflow — repeat build/lint/test/fix cycles up to 5 times until all checks pass. Stops early if the same error repeats 3 times (signals a fundamental issue, not a fixable one).

Dev UltraQA

Derived from oh-my-claudecode (MIT, Yeachan Heo). Adapted for the EvoNexus Engineering Layer.

QA cycling: keep running build/lint/test/fix loops until all checks pass — but with a circuit breaker. If the same error persists across 3 cycles, stop and report: it's a fundamental issue, not a fixable one.

Use When

• After a multi-file implementation (post-`dev-autopilot` or `@bolt-executor`)
• Pre-merge gate when you want all checks green before review
• Refactor that touches enough files to risk regressions

Do Not Use When

• Single-file change → just run `dev-verify` once
• The first failure is structural → escalate to `@apex-architect`, don't loop

Workflow

Each cycle:

1. Run **build** (`npm run build`, `cargo build`, `go build`) 2. Run **lint** (`npm run lint`, `cargo clippy`, `golangci-lint`) 3. Run **tests** (`npm test`, `cargo test`, `pytest`) 4. **If green:** done, exit cycle, hand off to `@oath-verifier` for final verification 5. **If red:** delegate to `@bolt-executor` or `@hawk-debugger` to fix the failure 6. **Loop** back to step 1

Circuit breaker (3-failure rule)

If the same error fingerprint (file:line + error message) appears in 3 consecutive cycles:

• STOP the loop
• Hand off to `@apex-architect` with full context dump
• The issue is no longer "fix the bug" — it's "question the architecture"

Max iterations

• Default: 5 cycles
• After 5 cycles even with different errors: stop and report

Output

Saved to `workspace/development/verifications/[C]ultraqa-{component}-{date}.md`:

## UltraQA Report

### Cycles
1. Build ❌ → fixed by @bolt-executor
2. Build ✅ Lint ❌ → fixed by @bolt-executor
3. Build ✅ Lint ✅ Tests ❌ → fixed by @hawk-debugger
4. ✅ All green

### Final State
- Build: ✅
- Lint: ✅
- Tests: ✅ N passed, 0 failed

### Handoff
- → @oath-verifier for evidence-based verification

Pairs With

• `@bolt-executor` (fixes during cycles)
• `@hawk-debugger` (fixes when bugs are non-trivial)
• `@oath-verifier` (final verification post-cycle)
• `@apex-architect` (escalation when 3-failure breaker trips)