rpi-review

Compare RPI planning and implementation evidence and record severity-graded review findings.

1.4k|284|Updated Nov 2, 2025
One-click install
npx skills add https://github.com/microsoft/hve-core --skill rpi-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rpi-review
Source: https://github.com/microsoft/hve-core/tree/main/.github/skills/rpi/rpi-review
Command: npx skills add https://github.com/microsoft/hve-core --skill rpi-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

After an implementation finishes, teams need an evidence-based acceptance review that separates whether work ran from whether the result is acceptable, and that routes every gap to the right follow-up stage instead of losing findings in chat.

Core Features & Use Cases

  • Evidence-based review record: Creates one canonical review log at .copilot-tracking/reviews/logs/ comparing plans, phase details, critiques, and changes records against acceptance criteria.
  • Execution vs. outcome separation: Records execution status (Complete, Partial, Blocked) independently from outcome (Conformant, Defects found, Residual work, Not accepted).
  • Finding routing: Routes severity-graded RV-xxx findings to distinct destinations: defects to rpi-implement, decision gaps to rpi-plan, evidence gaps to rpi-research, and residual work to follow-up items.
  • Use Case: After an RPI implementation phase completes, invoke this Skill to reconcile the plan against the changes record, assess validation evidence, and produce a single review record with routed follow-up actions.

Quick Start

Ask the agent to run an RPI review of the completed task using its plan, phase details, critique, and changes record.

Frequently Asked Questions about rpi-review

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

FAQPage Schema
How do I review an RPI implementation against its plan?

Invoke the rpi-review skill with the task's plan, phase details, plan critique, and changes record paths. It reconciles all artifacts, compares evidence against acceptance criteria, and writes one review record with severity-graded findings.

What is the difference between execution status and outcome in a review?

Execution status (Complete, Partial, Blocked) records whether planned work ran, while outcome (Conformant, Defects found, Residual work, Not accepted) records whether the result is acceptable. The review keeps these vocabularies strictly separate.

Where does the RPI review record get saved?

The review record is written to `.copilot-tracking/reviews/logs/{{YYYY-MM-DD}}/{{task_slug}}-review.md` using the bundled review-log template. Only this one canonical record may be created or updated during review.

Can the review skill fix defects it finds?

No. The review stage is read-only for all artifacts except its own review record. Defects are routed to a later rpi-implement invocation, decision gaps to rpi-plan, and evidence gaps to rpi-research.

When does an RPI review stop as Blocked or Not accepted?

It stops as Blocked when a reviewable artifact set cannot be formed or evidence is insufficient for a credible verdict. It stops as Not accepted when material defects or unaccepted decision gaps remain after comparison.