review-design

Review design documents against the codebase to report discrepancies.

160|16|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/janekbaraniewski/openusage --skill review-design-janekbaraniewski
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-design
Source: https://github.com/janekbaraniewski/openusage/tree/main/.opencode/skills/review-design
Command: npx skills add https://github.com/janekbaraniewski/openusage --skill review-design-janekbaraniewski

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps ensure that design documents are consistent with the actual codebase, reducing discrepancies and improving development alignment.

Core Features & Use Cases

  • Codebase Analysis: Scans the codebase to identify relevant sections related to a design document.
  • Discrepancy Highlighting: Pinpoints areas where the design document and code diverge.
  • Use Case: A product manager can use this Skill to verify that a new feature's implementation in code matches the approved design specifications before release.

Quick Start

Use the review-design skill to check the design document located at 'docs/design/new-feature.md' against the current codebase.

Frequently Asked Questions about review-design

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

FAQPage Schema
How do I check if my design document matches the codebase?

To check if a design document matches the codebase, you need a consistency check tool that scans source code repositories and compares them against design specs to pinpoint discrepancies. This Skill performs that exact codebase analysis to highlight architectural divergence.

What is design document review in software development?

Design document review is the process of verifying that approved design specifications align with the actual codebase implementation. It ensures architectural integrity by identifying and reporting discrepancies between the documented design and the source code.

How do I verify code implementation against approved design specifications?

You can verify code implementation by running a codebase analysis against the design document. This Skill reviews the design specs and source code repository to identify and report areas where the feature implementation diverges from the approved plan.

Do I need access to the source code repository to review design docs?

Yes, you need access to both the design documents and the source code repository. This Skill requires comparing the design file against the actual codebase to perform a consistency check and identify architectural discrepancies.

What is the best way to maintain architectural integrity during feature development?

The best way to maintain architectural integrity is to perform regular consistency checks between design documents and the codebase. This highlights discrepancies early, ensuring the software development workflow maintains feature consistency before release.

Why does my code implementation diverge from the design document?

Code implementation diverges from the design document when development changes are not reflected in the specs. A codebase analysis identifies these specific discrepancies by reviewing the source code repository against the original design document.