defprod-change-review

Reviews a change's diff for correctness, security, test coverage, and scope fidelity before it lands.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/defprod1/defprod-skills --skill defprod-change-review-defprod1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: defprod-change-review
Source: https://github.com/defprod1/defprod-skills/tree/main/skills/defprod-change-review
Command: npx skills add https://github.com/defprod1/defprod-skills --skill defprod-change-review-defprod1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Code changes often land with hidden regressions, security gaps, or scope drift from the user stories they were meant to implement. This Skill performs a structured, high-confidence review of a change's diff before it ships, filtering out noise so only real, change-introduced issues surface. ## Core Features & Use Cases - Multi-lens diff review: Judges the diff across correctness, error handling, security, test coverage, scope fidelity against acceptance criteria, and repo conventions. - Confidence-scored findings: Scores every candidate finding 0-100 and discards anything below 80, eliminating pre-existing issues, linter-catchable problems, and nitpicks. - Severity-ranked verdict: Tags surviving findings as blocking, important, or minor, fixes clear-cut defects, and only finishes the stage when no blocking or important finding remains. - Use Case: Before merging a branch implementing a user story, run the review to verify the diff satisfies the story's acceptance criteria, introduces no security holes, and keeps existing tests valid. ## Quick Start Ask your AI agent to review the current change's diff using the defprod-change-review skill and report any blocking or important findings.

Frequently Asked Questions about defprod-change-review

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

FAQPage Schema
How do I review a code change diff with an AI agent?

Invoke the review stage on the current change: the agent scopes the diff, gathers context from callers, tests, and git history, then judges the changes across correctness, security, and test coverage lenses. Findings are confidence-scored and only high-confidence issues are reported.

How does the review filter out false positive findings?

Each candidate finding receives a 0-100 confidence score that it is a real, change-introduced issue, and anything below 80 is discarded. Pre-existing issues, linter-catchable problems, nitpicks, and deliberately silenced code are scored down and dropped.

Does this review work with Cursor or only Claude Code?

It works on any agent host that reads .claude/skills/, including Claude Code, Cursor, and OpenCode. The skill relies only on Read, Grep, Bash, and the DefProd MCP server, so it produces the same review regardless of host.

Can the review run without a DefProd change context?

Yes. If no change context resolves from .defprod/change, the branch name, or a commit trailer, the review proceeds silently without stage stamping. Stale contexts pointing to shipped or cancelled changes are disregarded.

What happens when the review finds blocking issues?

Blocking and important findings must be resolved before the stage finishes. Clear-cut defects are fixed directly, judgement calls are raised with the user in interactive mode, and accepted findings are recorded in the finish note.