agentleFS
mepottsmepotts/agent-operating-kit/skills/refute-review/SKILL.md

refute-review

Skill0 starsChanged 43 days agoMITView on GitHub

Verify that an agent's work is really done by trying to refute it (re-run the checks, read the assertions, run a red-green proof, demand evidence). Use when an agent or person claims work is done, fixed, passing or ready to merge, when asked to review, double-check, audit or independently verify a change, or when asked how to check an agent's claim.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If it is pinned to one branch, say so: a claim that needs another branch is reported unsupported, not guessed.

    line 21
  2. Distinctive:

    Read each assertion. A matching test name is not proof.

    line 26
  3. Distinctive:

    Look beside the fix for the same defect shape.

    line 31
  4. Distinctive:

    Check scope: files touched, new dependencies, weakened assertions, regenerated baselines.

    line 32
  5. Distinctive:

    After a batch merges, review the merged branch as a whole.

    line 39

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Refute review

Goal: find what would make "done" false. Approval is the absence of a refutation, not the presence of a summary.

Agents: refuting-reviewer for one change, auditor (finder, then skeptic) for a broad sweep. Command: /agent-operating-kit:refute.

Independence

  • A fresh context that is not the implementer and is told to refute, not bless.
  • It reads the diff, the assertions and the direct artifacts, and re-runs the checks itself. The implementer's report is a list of claims to test, never evidence.
  • A different model, extra votes or a title does not make a review independent.

Brief

  • The outcome under review. Checkout path, branch and exact revision. The files it may touch.
  • The claims, verbatim, marked untrusted. The acceptance checks and the risk tier.
  • "Try to refute this. Report what you could not verify."
  • If it is pinned to one branch, say so: a claim that needs another branch is reported unsupported, not guessed.

What the reviewer does

  1. Pin the candidate (revision, dirty flag). Review the diff, not the summary.
  2. Re-run every acceptance check. Record command, exit code and counts. "Skipped" and "0 tests found" are failures until shown otherwise.
  3. Read each assertion. A matching test name is not proof. An at-most check cannot show a bound got tighter.
  4. Red-green. Revert the fix in a throwaway copy: the new test must fail. Restore it: the test must pass.
  5. Hollow gate. Break what the gate exists to catch: it must go red. Cases generated from a directory or manifest can vanish instead of failing.
  6. Grader fault injection. An eval or model judge earns trust only if it fails when the behavior it grades is deliberately broken.
  7. Trace from the real entry point to the changed code and confirm the shipped artifact contains it.
  8. Look beside the fix for the same defect shape.
  9. Check scope: files touched, new dependencies, weakened assertions, regenerated baselines.

Verdict

PASS, PASS WITH FOLLOW-UPS or FAIL. A status per claim. Findings with reproduction steps. The commands run. What was not verified.

After

  • A FAIL goes back to the implementer, not to the reviewer. Re-review the new revision from scratch.
  • After a batch merges, review the merged branch as a whole. Per-change reviewers attack only their own diff, so regressions live between changes.
  • For a high-severity finding use two skeptics with different lenses (for example reachability from the entry point, and correctness against existing mitigations). Drop it only if both refute it. Settle disagreement by reading code or running the check, not by vote.
  • For a broad audit, give each auditor finder a slice with no gaps and no overlaps, then run skeptics on the strongest model available.
  • Depth follows the risk tier. Agent count is not a success metric.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.