| description | Root-cause diagnosis protocol — confirm root cause before fixing; post-fix validation loop; challenger feedback; anti-patterns | |
|---|---|---|
| paths |
|
Never patch symptom. Diagnosis: observe ALL symptoms → hypothesize specific mechanism → confirm with evidence (code/logs/tests — no confirmation = no fix) → fix mechanism, not signal → validate ALL original symptoms. An explicitly invoked iterative review-and-fix loop follows the Adversarial Convergence Loop in quality-gates.md, including its evidence, score and stop rules; ordinary diagnosis does not start that loop.
- Memory/training knowledge ≠ evidence — every premise must be grounded in source read now (
quality-gates.md§Evidence Grounding) - Falsification before closing: could a second independent root cause remain? If yes, diagnose it too
- Same failure signature twice in a row → stop immediately — repeat means the attempt added no new information
- Run one bounded independent post-fix challenge under the proportional workflow in
quality-gates.md; do not turn it into an iterative loop without explicit invocation.- A re-scan gated on a named, checkable trigger is targeted verification, not the routine recheck this excludes.
- For that challenge: dispatch
foundry:challengerviaAgent()— batched per session (one challenger for grouped fixes), file-handoff envelope, read full findings only on FAIL; never assubagent_type: "fork"— fork inherits implementer's reasoning trail, biases verification toward confirming it; challenger gets only diff + symptom + spec
- Tool/command failure: diagnose cause once, adapt approach — never retry identical call expecting different result
- Anti-patterns (forbidden): symptom suppression (
try/except/guard hiding failure), first-plausible-cause stop, partial validation, fix-before-confirm, ungrounded premise as design pillar
Full protocol (diagnosis-loop detail, challenger dispatch rules, Tier-1/2 evidence standards) in
_full/debugging.md. Read before any multi-file or behaviour-changing fix:RULE_FULL="$(ls -td ~/.claude/plugins/cache/borda-ai-rig/foundry/*/rules/_full/debugging.md 2>/dev/null | head -1)"; [ -z "$RULE_FULL" ] && RULE_FULL="plugins/cc_foundry/rules/_full/debugging.md" # timeout: 5000