skills.rest
windyroad
windyroadOFFICIAL
Explore all skills by this author →
WebsiteGitHub

wr-architect:review-design

Compare staged changes and commits against ADRs in docs/decisions/.

4|1|Updated Apr 7, 2026
Search Tags:#architecture#adr#compliance#governance#review#code-review#docs/decisions
One-click install
npx skills add https://github.com/windyroad/agent-plugins --skill wr-architect-review-design
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wr-architect:review-design
Source: https://github.com/windyroad/agent-plugins/tree/main/packages/architect/skills/review-design
Command: npx skills add https://github.com/windyroad/agent-plugins --skill wr-architect-review-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADRs guide architecture decisions; this skill automates a pre-check by reviewing staged changes and recent commits against ADRs in docs/decisions/.

Core Features & Use Cases

  • On-demand architecture compliance review against ADRs before editing architecture-bearing files
  • Flag ADR gaps and propose updates to decisions to prevent architectural drift
  • Provide a clear PASS/FLAGGED/NEW ADR NEEDED report before proceeding

Quick Start

Call the skill to review your staged changes and recent commits against ADRs before editing architecture-bearing files.

Frequently Asked Questions about wr-architect:review-design

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

FAQPage Schema
How do I automate architecture compliance checks against ADRs before a code review?▼

Architecture compliance review is automated by comparing staged changes and recent commits against ADRs in docs/decisions/ to flag violations before editing architecture-bearing files.

What is the best way to prevent architectural drift when modifying architecture-bearing files?▼

Preventing architectural drift requires on-demand ADR-based review to flag ADR gaps and propose updates, ensuring decisions remain aligned with code changes during large refactors.

When do I need an architecture compliance review for a large refactor?▼

An architecture compliance review is needed before editing architecture-bearing files during releases or large refactors in projects that maintain ADRs in docs/decisions/.

How does an ADR compliance review report its findings after checking recent commits?▼

The ADR compliance review reports findings by presenting a structured PASS, FLAGGED, or NEW ADR NEEDED status detailing violations or missing decisions before you proceed.

Related Skills

Explore More Software Engineering Skills→
peelpeel
3

docs-evolve

Update SYSTEM.md, ADRs, and BACKLOG.md from Git diffs and completed code.

Community
Intermediate
fabioabrfabioabr

adr-reviewer

Review ADRs for ADR-001 compliance and generate QA reports.

Community
Advanced
Hack23Hack23
8

security-architecture-validation

Validate code changes against ISMS security architecture and documentation requirements.

Official
Basic
outcomeengineeringoutcomeengineering
1

reviewing-typescript

Review TypeScript code for design flaws and architectural compliance.

Official
Advanced