architecture-review

Validate project architecture against CDD requirements and ADR decisions.

18|5|Updated Nov 25, 2025
One-click install
npx skills add https://github.com/wsman/MY-DOGE-MICRO --skill architecture-review-wsman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/wsman/MY-DOGE-MICRO/tree/main/.agents/skills/architecture-review
Command: npx skills add https://github.com/wsman/MY-DOGE-MICRO --skill architecture-review-wsman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams verify that a project's architecture fully covers its design requirements, stays internally consistent, and avoids risky implementation assumptions before work begins.

Core Features & Use Cases

  • Requirement Traceability: Maps each CDD requirement to one or more ADRs and highlights gaps or partial coverage.
  • Conflict Detection: Compares ADRs for contradictions in ownership, integration contracts, dependencies, and performance budgets.
  • Technology Audit: Checks version alignment, deprecated API usage, and compatibility blind spots across the architecture.
  • Use Case: A product or platform team can run it before implementation to decide which ADRs are missing, which decisions conflict, and whether the architecture is ready to proceed.

Quick Start

Run the architecture review on this repository to identify requirement gaps, ADR conflicts, and technology risks.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I check if my project architecture covers all CDD requirements?

An architecture review validates project architecture against CDD requirements by mapping them to ADRs, highlighting coverage gaps, and outputting a PASS, CONCERNS, or FAIL verdict.

How do I detect conflicts between ADRs in my repository?

An architecture review detects ADR conflicts by comparing decisions for contradictions in integration contracts, dependency ordering, ownership, and performance budgets.

What is an architecture technology audit for version and API compatibility?

A technology audit checks version alignment, deprecated API usage, and compatibility blind spots across your architecture to ensure implementation safety.

Can I use an architecture review to find missing ADRs before implementation?

Yes, an architecture review identifies missing ADRs, conflicting decisions, and technology risks to determine if your architecture is ready to proceed before implementation.

When should I not use a full architecture traceability review?

Avoid a full architecture traceability review if your repository lacks formal CDD requirements or ADR decisions, as it requires extracting these documents to build a requirement-to-ADR matrix.