sdd-review

Compare git diffs against SDD plans and flag unplanned changes.

1|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/davidarce/devrune-starter-catalog --skill sdd-review-davidarce
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-review
Source: https://github.com/davidarce/devrune-starter-catalog/tree/main/workflows/sdd/sdd-review
Command: npx skills add https://github.com/davidarce/devrune-starter-catalog --skill sdd-review-davidarce

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps AI-driven reviewers compare code changes against an SDD plan, surface deviations, and coordinate with advisors to ensure architectural alignment and quality.

Core Features & Use Cases

  • Compare diffs against an .sdd/{change-name}/plan.md to verify coverage of planned work.
  • Flag unplanned changes and highlight regressions for rapid remediation.
  • Enable advisor-assisted review for high-risk changes and compliance checks.

Quick Start

Execute a repository diff and reference the SDD plan to begin the review loop.

Frequently Asked Questions about sdd-review

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

FAQPage Schema
How do I review code changes against an SDD plan?

You review code changes against an SDD plan by comparing repository git diffs against the .sdd/{change-name}/plan.md file to verify planned work coverage and flag any unplanned deviations or regressions.

What is an SDD plan alignment review for git diffs?

An SDD plan alignment review is a process that identifies code changes in a git diff, compares them to a structured plan.md file, and flags unplanned modifications to ensure architectural alignment before committing.

How do I flag unplanned code changes in a pre-commit review?

You flag unplanned code changes in a pre-commit review by running a repository diff through an automated review loop that checks the changes against the original SDD plan to highlight regressions for rapid remediation.

Can I validate high-risk git diffs with advisor integrations?

Yes, you can validate high-risk git diffs by enabling advisor-assisted review, which consults optional advisor integrations during the diff comparison to perform compliance checks and catch critical issues.

Does the code review workflow require a plan.md file to function?

No, the code review workflow does not strictly require a plan.md file to function; it operates in standalone mode to review diffs independently, but utilizes the .sdd/{change-name}/plan.md for SDD-context alignment when provided.

What are the limitations of standalone diff review without an SDD plan?

In standalone diff review without an SDD plan, the limitation is that the Skill cannot verify coverage of planned work or flag unplanned architectural deviations, restricting its analysis to the raw code changes present in the git diff.