← All craftbooks

Reviewer Loop

Ship and releaseevalv1.0.0released 2026-05-05workflow: review-loop

Draft → critique → revise (looped until approved) → publish. A repeatable critique-and-revise pattern with explicit branching.

Steps

Entry step: draft. Each step names the specialist role it wants; the full working prompt is expandable.

  1. Draftwriterentry

    Produce the first cut of the requested artifact and make the review target explicit.

    Show working prompt
    Create the first complete draft of the requested artifact. Before writing, identify the deliverable path, audience, and 4-6 acceptance criteria in task notes. Then write the draft with the appropriate file-writing tool. Do not ask for critique until a real draft exists. When the draft is written, add a short task note naming the path and the criteria it is intended to satisfy, then call `advance_task_step({ ref, stepId: "draft", next: "evaluate" })`.
  2. Critiquereviewer

    Review the draft against the criteria and route either to revision or publish.

    Show working prompt
    Act as the reviewer. Read the deliverable and the acceptance criteria from task notes. Write a concrete critique to task notes with PASS/FAIL for each criterion and no vague style advice. If every criterion passes, call `advance_task_step({ ref, stepId: "evaluate", next: "publish" })`; publish is the finish route. If any criterion fails, write the specific gaps and call `advance_task_step({ ref, stepId: "evaluate", next: "revise" })`. Never route to publish or finish while a criterion is unmet.
  3. Revisewriter

    Address the named critique without redesigning unrelated parts.

    Show working prompt
    Revise the deliverable to address exactly the critique in task notes. Preserve criteria that already passed. Make a real file edit; a prose promise is not enough. After editing, write a short task note listing which critique items were fixed and call `advance_task_step({ ref, stepId: "revise", next: "evaluate" })` so the reviewer can check the revision.
  4. Publishwriter

    Stamp the final summary after reviewer approval.

    Show working prompt
    The reviewer approved the artifact. Write a one-paragraph DONE summary to task notes naming the final deliverable path and the acceptance criteria that passed. Then report DONE.

Triggers

Phrases that suggest this craftbook to a crew.

Source

View this craftbook on GitHub · MIT license