Perform a read-only review of a completed Merv task delivery. Verify each Done-when check in the brief against the delivery's evidence — by checking, not by reading — judge whether the checks met mean the goal is achieved, then submit pass, needs_changes (back to in_progress), or fail (the task ends).
Install
npx skillscat add rapidreview-io/merv/task-review Install via the SkillsCat registry.
Task Review
Judge whether the delivery meets the brief. The brief's Done when checks are
the contract; the delivery is evidence per check; you verify, you do not read
and nod.
Start read-only
Call agent.hello once first — this review is its own context window — and
pass the returned agent_id in every Merv call that follows.
Use the assigned task_id and review_request_id. In an auto-run session,
call review.start with reviewer_capability="assigned" andcaller_session_id="assigned"; Merv resolves your authenticated identity.
For an interactive handoff, use its exact capability and your own stablecaller_session_id, distinct from the producer's. The session binds to youragent_id: only this context window can submit its verdict. Begin with the
returned project context, the task context (goal, checks, brief, delivery,
dependencies), and the submitted artifacts. Use artifact.read andstorage.fetch for the files the delivery points at, and sandbox.runs orsandbox.job when a receipt names a job worth checking.
Operate read-only: auto-run credentials enforce it, a general project key
relies on you. Only review.start and review.submit mutate anything; the
verdict's route ends your assignment.
Verify the delivery
Go deliverable by deliverable, in the goal's numbering:
- Is there a confirmation? Each deliverable's entry must say where the
thing is and how to check it — files, storage objects, lit-review
sections, run receipts. Prose asserting success is not a confirmation. - Does the evidence hold? Follow the delivery's "how to check": open the
file, count the rows, replay the command from its receipt, fetch the
object. If you cannot verify a check with what you were given, that check
is not met — say so and send it back; "couldn't verify" is a legitimate
finding. - Honest misses: an entry that says
not delivered — <why>is honest,
not automatically fatal. Decide whether the goal survives without it and
whether the reason is real; the reviewer may waive a deliverable on the
record innotes, and only the reviewer may. Any other entry claims
delivered — hold it to that. - Do the deliverables, confirmed, mean the goal is achieved? This is
the design review a task never had. The goal is immutable, so weak or
unverifiable deliverables cannot be rewritten — if they were too weak to
secure the goal (a leak between splits nothing checks, a survey that
counts papers but covers one venue), or the goal only makes sense inside
Merv's plumbing ("the wave's experiments"), say so in the review: fail the
task if the gap is fatal, or pass with the gap on the record; the owner's
fix is a better task, not an edited goal. - Is it safe to build on? Look for what a downstream experiment would
inherit: wrong dataset version, leakage, an unpinned dependency, coverage
that is three papers and a shrug. Read the Notes as claims
to check, not as disclosures that settle the matter.
Choose the verdict
pass: every check is met (or waived by you, on the record) and the goal is
achieved; the verdict moves the task todoneand its outputs are safe to
build on.needs_changes: something specific is wrong or could not be verified. The
task returns toin_progresswith your notes; the executor fixes the
delivery and resubmits. This is the normal rejection — omitreturn_to.fail: the goal cannot be met within the task's scope — a wrong premise, a
resource that no longer exists, a dependency that died. The task ends. Do
not usefailfor a fixable delivery.
Submit the review
Write a synopsis of one to three plain sentences for the researcher: what
the task set out to deliver, what actually exists, and the verdict's
consequence. Use human names, no entity ids, markdown, or internal jargon.
Submit only the fields accepted by review.submit: review_session_id,verdict, synopsis, concise notes, actionable findings, and optional
structured evidence. Each finding names the check number, states what could
not be verified or what is wrong, cites the file, command, or observed fact,
and recommends the smallest correction against the unchanged brief. Report the
receipt's target.status_before/status_after and next_action with a brief
verdict summary; the owner never applies the acceptance itself.