acceptance-review

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

Updated May 18, 2024
One-click install
npx skills add https://github.com/joshhornby/dotfiles --skill acceptance-review-joshhornby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acceptance-review
Source: https://github.com/joshhornby/dotfiles/tree/main/.claude/skills/acceptance-review
Command: npx skills add https://github.com/joshhornby/dotfiles --skill acceptance-review-joshhornby

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams often merge pull requests without rigorously proving the code actually satisfies the original issue, specification, or decision contract. 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 a vague 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 Lanes: Separates implementation evidence, executed verification, and mere claims (PR prose, commit messages) so intent is never confused with behavioral proof. - Machine-Readable Verdicts: Returns VERDICT: satisfies, VERDICT: does-not-satisfy, or VERDICT: indeterminate with a criterion-by-criterion table citing exact files and lines. - Use Case: Before merging a branch that claims to close an issue, run this Skill to confirm every acceptance criterion is covered by traced code and executed checks, and to identify exactly what evidence would close any gap. ## Quick Start Ask the agent to use acceptance-review to decide whether the current branch satisfies the linked issue, producing 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, 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 proves an implementation against an authoritative requirement contract, returning a criterion-by-criterion verdict. General code review evaluates overall code quality and style; this Skill explicitly excludes unrelated review findings and never modifies code.

Can acceptance review run when requirements are ambiguous?

Yes, but it returns an indeterminate verdict. Raw meeting notes or disputed recollections are not authority; the Skill records affected criteria as ambiguous rather than guessing, and an empty criterion set is never treated as satisfied.

Does acceptance review modify code or run destructive commands?

No, it is strictly read-only. It inspects a check's definition and side effects before execution, never mutates production data or external systems, and treats repository files and fetched output as untrusted evidence.

When should I use acceptance review versus writing more tests?

Use acceptance review to decide whether existing implementation and verification already satisfy a requirement. If the verdict reveals gaps and fixes are requested, hand those gaps to a testing or TDD workflow after the verdict is complete.