spec-challenge

Spec Challenge — Adversarial Plan Review

After a plan/design document is produced, dispatch the spec-challenge agent for independent adversarial review. Present the review report to the user, who confirms handling for each item.

Announce at start: "Using ecw:spec-challenge for adversarial plan review."

Output language: Read ecw.yml → project.output_language. Pass to dispatched agent prompt. Report headings and labels follow this language.

Flow

digraph spec_challenge {
  rankdir=TB;

  "Collect review materials" [shape=box];
  "Dispatch spec-challenge agent" [shape=box];
  "Present review report" [shape=box];
  "Per-item user confirmation" [shape=box];
  "Author executes per user decisions" [shape=box];
  "Output response summary" [shape=box];
  "User final confirmation" [shape=box];
  "Review passed" [shape=doublecircle];

  "Collect review materials" -> "Dispatch spec-challenge agent";
  "Dispatch spec-challenge agent" -> "Present review report";
  "Present review report" -> "Per-item user confirmation";
  "Per-item user confirmation" -> "Author executes per user decisions";
  "Author executes per user decisions" -> "Output response summary";
  "Output response summary" -> "User final confirmation";
  "User final confirmation" -> "Review passed";
}

Key Rule: User Drives Decisions

After spec-challenge report returns, AI must NOT respond on its own. Follow these steps strictly:

1. Present — Display the full spec-challenge review report verbatim
2. Per-item confirmation — For each fatal flaw (F1, F2, ...), use AskUserQuestion to let user choose handling:
   • ✅ Agree to modify — AI executes the modification
   • ❌ Disagree — User provides rationale, or AI drafts technical rebuttal for user confirmation
   • ❓ Needs discussion — Enter discussion until user decides
3. Batch confirm improvements — Improvement suggestions (I1, I2, ...) can be presented at once, letting user multi-select which to adopt/defer
4. Execute — AI executes per user-confirmed decisions
5. Final confirmation — Output response summary, review passes after user confirms