perfection-review

Reviews pull request diffs against an ideal bar using adversarial verification workflows.

957|79|Updated May 9, 2021
One-click install
npx skills add https://github.com/srid/emanote --skill perfection-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perfection-review
Source: https://github.com/srid/emanote/tree/main/.agents/skills/perfection-review
Command: npx skills add https://github.com/srid/emanote --skill perfection-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standard code reviews settle for "correct enough" and miss defects that resurface one seam over after each fix. This Skill holds a change to an ideal bar — where the defect can no longer be expressed — and tracks it across review rounds until it has nowhere left to relocate.

Core Features & Use Cases

  • Diff-grounded adversarial review: Treats PR descriptions, commit messages, and author claims as assertions to falsify against the actual code, not facts to trust.
  • Defect relocation hunting: Names the underlying defect shape and tracks where it resurfaces across review rounds, rather than accepting one-line patches that merely move the problem.
  • Fanned-out verification via Workflow: Spawns fresh-context verifiers (one per claim) plus an isolated adversary whose only job is to express the defect anyway, then synthesizes findings.
  • Use Case: After a contentious bug fix PR, invoke this Skill to verify the fix actually makes the defect impossible to express, identify residual surfaces ranked by invariant violated, and get a structural fix for each.

Quick Start

Ask the AI to run a perfection review on PR 42 against the main branch and report the residual defect surfaces with structural fixes.

Frequently Asked Questions about perfection-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a pull request for perfection instead of just correctness?

Invoke this Skill with a PR number to hold the change to an ideal bar where the defect can no longer be expressed. It grounds every claim in the diff, hunts where the defect relocates, and reports residual surfaces with structural fixes.

What is adversarial code review with AI agents?

Adversarial review fans out fresh-context verifier agents, one per claim, plus an isolated adversary whose only job is to express the defect anyway. Each agent cites the diff, and results are synthesized with a refuted-if-uncertain default.

When should I use a perfection review instead of a normal code review?

Use it only when explicitly seeking an ideal-bar review, such as making a defect impossible to express or tracking where a defect relocates across rounds. It assumes eternal time and no ship pressure, so it is not suited for routine reviews.

Can the perfection review post findings directly to a GitHub PR?

Yes, but only when explicitly requested with the --post flag. By default the review reports findings without posting, leading with credit for what is closed before listing ranked residual surfaces.

Why do fixed bugs keep reappearing after code review?

A fix that satisfies the literal ask often lets the same defect shape resurface one seam over. This Skill names the defect's shape and tracks it across rounds until it has nowhere left to relocate.