acceptance-review

Verifies implementations against authoritative acceptance criteria with criterion-by-criterion evidence and verdicts.

723|93|Updated Nov 14, 2021
One-click install
npx skills add https://github.com/citypaul/.dotfiles --skill acceptance-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acceptance-review
Source: https://github.com/citypaul/.dotfiles/tree/main/claude/.claude/skills/acceptance-review
Command: npx skills add https://github.com/citypaul/.dotfiles --skill acceptance-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Teams often cannot tell whether a pull request, branch, or diff actually satisfies the issue, specification, or decision contract it claims to implement. This Skill performs a read-only audit that maps every normative requirement to a decidable criterion, traces the production code path, executes verification checks, and returns a clear acceptance verdict instead of an opinionated code review.

Core Features & Use Cases

  • Contract Construction: Resolves the authoritative artifact (issue, spec, or accepted decision), maps each normative statement to one criterion, and records ambiguities and exclusions.
  • Evidence-Based Tracing: Separates implementation, verification, and claim evidence lanes, citing exact files and lines while treating repository prose and logs as untrusted input.
  • Machine-Readable Verdicts: Returns VERDICT: satisfies, VERDICT: does-not-satisfy, or VERDICT: indeterminate with a criterion table listing status, implementation evidence, and verification evidence.
  • Use Case: Before merging a feature branch, run the review against the original GitHub issue to confirm each acceptance criterion is covered, partial, missing, regressed, or unverified, with the minimum evidence needed to close gaps.

Quick Start

Use acceptance-review to decide whether this branch fulfils the linked issue with a criterion-by-criterion proof and verdict.

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?

Run an acceptance review that maps each normative statement in the issue to a decidable criterion, traces the production code path for each one, and executes the smallest check that exercises the observable outcome. The result is a verdict of satisfies, does-not-satisfy, or indeterminate with cited evidence.

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

Acceptance review only decides whether an implementation satisfies an authoritative requirement contract, criterion by criterion. General code review covers style, design, and unrelated findings, which this process explicitly excludes from its report.

Can acceptance review run without executing tests?

Yes, but with limits. If execution is unavailable or unauthorized, the review records a named verification gap and may return an indeterminate verdict. Decisive static evidence is accepted only when execution would add no information.

What happens when requirements are ambiguous or disputed?

Raw meeting notes or disputed recollections are not treated as authority. The review locates the current accepted artifact, records affected criteria as ambiguous, and returns an indeterminate verdict when no in-scope acceptance criterion exists.

When should I not use acceptance review?

Do not use it to improve the written requirement artifact, reconstruct meetings, perform general code review, or implement fixes. Those tasks belong to gap-finding, independent review, and test-driven development skills respectively.