Perform a read-only adversarial review of a Merv project-reflection wave. Check the reflection document and change spec against the snapshotted corpus and five lens reflections, then submit the verdict and correct return path.
Install
npx skillscat add rapidreview-io/merv/project-reflection-review Install via the SkillsCat registry.
Project Reflection Review
Protect the honesty of the project's distilled memory. Judge whether the
reflection absorbed the new evidence, reconciled its five lenses, and proposed
a safe next experiment wave.
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 reflection_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. It returns the
project context, reflection context, and submitted artifacts. Use those
snapshots rather than live experiment state. Read a listed artifact id withartifact.read include_content=true only when a load-bearing summary needs
exact verification.
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.
Review the evidence layers
Read:
- The snapshotted claims, experiments, reports, and review history.
- The previous published reflection, when present.
- All five current lens documents.
- The submitted reflection document and change spec.
Treat lens documents as unverified arguments. Check important assertions
against the underlying snapshot, distinguishing experimental confirmation from
useful task output. Verify that the next tests could distinguish the stated explanations.
Judge the reflection
- New signal: Did
new_terminal_experiments(andnew_terminal_tasks)
materially affect the reflection or the decision where warranted? A wave
that could have been written before them did not do its job. - Honest reflection: Does the reflection document preserve contested
findings, negative results, dead ends, and current uncertainty rather than
hiding known rework? Verify load-bearing statements against their
references. Judge substance, not the author's vocabulary. - Real reconciliation: Were lens disagreements resolved against evidence
or carried forward explicitly, rather than averaged or copied? - Consequential coverage: Did synthesis preserve important negative
knowledge and omit only editorially minor material? - Critical document: Is the reflection concise and scientific—what
changed, what remains uncertain, where lenses disagree, and why the next
direction follows—rather than a paste-up of five summaries? - Distinct lenses: Did the five lenses produce genuinely different
analyses? Near-duplicate or charter-ignoring inputs are a lens failure. - Belief update: Are claim changes warranted by reviewed evidence and
scoped honestly? - Next wave: Do the proposed experiments address live research questions,
avoid known dead ends unless conditions changed, and contain enough intent
to materialize? Claim references are optional, but every provided reference
must genuinely match what the experiment tests. Are the proposed tasks
scoped and not over-prescribed — a goal, checks an executor can meet and a
reviewer can verify, no method dressed up as a check — and does thedepends_onDAG order the wave sensibly (data before the experiment that
trains on it) without inventing dependencies that only serialize work? A
task that exists to test a claim is an experiment in disguise.
Choose the verdict and return
pass: the reflection is critical and the change spec is authoritative; the
verdict moves the wave toconsolidatingfor a separate consolidator.needs_changesorfail: reject with exactly one return path.
Use return_to: "synthesizing" when the lens inputs stand but the reflection
document, claim changes, or experiment proposals need revision.
Use return_to: "reflecting" only when the lens inputs themselves are
inadequate; this advances the attempt and requires all five lenses again.
Do not rerun five agents to repair a synthesis error.
Submit the review
Write a synopsis of one to three plain sentences for the researcher: what the
wave concluded and the verdict's consequence. Use human names, at most one
decisive comparison, and no entity ids, markdown, or internal jargon.
Submit only the fields accepted by review.submit:review_session_id, verdict, required return_to unless passing,synopsis, concise notes, actionable findings, and optional structuredevidence naming what was checked.
Each finding should identify the specific claim, lens document, or record that
demonstrates the issue and recommend the smallest correction. Report
the receipt's target.status_before/status_after and next_action with a
brief verdict summary.