acceptance-review

Verifies code against an authoritative acceptance contract with criterion-by-criterion proof.

3|Updated Nov 8, 2014
One-click install
npx skills add https://github.com/mintuz/.dotfiles --skill acceptance-review-mintuz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acceptance-review
Source: https://github.com/mintuz/.dotfiles/tree/main/agents/.agents/skills/acceptance-review
Command: npx skills add https://github.com/mintuz/.dotfiles --skill acceptance-review-mintuz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often merge pull requests without rigorously proving the code actually satisfies the linked issue, specification, or decision record. This Skill turns an authoritative requirement into an acceptance contract and produces a criterion-by-criterion verdict instead of a vague approval. ## Core Features & Use Cases - Contract Construction: Maps every normative statement from an issue, spec, or decision record into independently decidable criteria, recording ambiguities and exclusions. - Evidence-Based Proof: Traces production code paths, runs targeted checks, and separates implementation evidence, verification evidence, and mere claims. - Structured Verdicts: Classifies each criterion as Covered, Partial, Missing, Regressed, or Unverified, then issues an overall Satisfies, Does not satisfy, or Indeterminate verdict. - Use Case: Before merging a feature branch, run the review against the linked issue to get a table showing exactly which requirements are proven, which are partial, and what evidence would close each gap. ## Quick Start Use the acceptance-review skill to decide whether this branch fulfills the linked issue with a criterion-by-criterion proof.

Frequently Asked Questions about acceptance-review

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

FAQPage Schema
How do I verify a pull request satisfies its linked issue?

Provide the branch or diff plus the authoritative issue or specification. The review maps each normative statement to a criterion, traces the production code path, runs targeted checks, and returns a verdict table showing Covered, Partial, Missing, Regressed, or Unverified per criterion.

What is the difference between acceptance review and general code review?

Acceptance review judges code only against an authoritative requirement contract and returns a satisfaction verdict. General code review covers style, maintainability, and quality concerns, which are explicitly kept outside the acceptance report.

Can acceptance review run without a linked issue or specification?

No. The review stops and requests an authoritative requirement when none is supplied. It never builds the contract from the diff, pull request description, or review request itself, since those are not authoritative sources.

What happens when two conflicting policies both claim authority?

The criterion is tested against every candidate policy. If candidates produce different statuses, the criterion is marked Unverified and the lineage or supersession evidence needed to resolve the conflict is named. If all candidates agree, that status is reported with the conflict noted.

When should decision tracing run before acceptance review?

Decision tracing runs first when authority begins in a meeting or transcript, when the claimed decision is disputed, or when two policies conflict without a supersession marker. Its acceptance handoff is consumed rather than reinterpreting raw sources.