speckit-adlc-architect-analyze

Compare ADRs with AD.md to detect drift and quality gaps.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/chaimt/GarminShabbatMode --skill speckit-adlc-architect-analyze
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-adlc-architect-analyze
Source: https://github.com/chaimt/GarminShabbatMode/tree/main/.cursor/skills/speckit-adlc-architect-analyze
Command: npx skills add https://github.com/chaimt/GarminShabbatMode --skill speckit-adlc-architect-analyze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze architecture artifacts to ensure consistency between Architecture Decision Records (ADRs) and Architecture Description (AD.md), identify gaps, and surface quality issues.

Core Features & Use Cases

  • Read ADRs and AD.md to detect drift and inconsistencies across architecture views
  • Validate ADR quality against MADR-like criteria and surface gaps
  • Generate structured analysis reports with actionable remediation guidance

Quick Start

Run the analyze tool to compare ADRs with AD.md and report drift and quality issues.

Frequently Asked Questions about speckit-adlc-architect-analyze

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

FAQPage Schema
How do I detect architecture drift between ADRs and AD.md files?

Architecture conformance analysis validates ADRs against MADR-like criteria and compares them with AD.md to surface quality gaps. It reports drift, missing decisions, and terminology inconsistencies across system-level and feature-level architecture views with actionable remediation guidance.

How do I validate ADR quality against MADR criteria?

Architecture conformance analysis validates ADRs against MADR-like criteria and compares them with AD.md to surface quality gaps. It reports drift, missing decisions, and terminology inconsistencies across system-level and feature-level architecture views with actionable remediation guidance.

Can I analyze feature-level ADRs or is it limited to system-level architecture?

Architecture conformance analysis validates ADRs against MADR-like criteria and compares them with AD.md to surface quality gaps. It reports drift, missing decisions, and terminology inconsistencies across system-level and feature-level architecture views with actionable remediation guidance.

What is the best way to report missing decisions in architecture documentation?

Architecture conformance analysis validates ADRs against MADR-like criteria and compares them with AD.md to surface quality gaps. It reports drift, missing decisions, and terminology inconsistencies across system-level and feature-level architecture views with actionable remediation guidance.

Does architecture analysis detect terminology drift in AD.md?

Architecture conformance analysis validates ADRs against MADR-like criteria and compares them with AD.md to surface quality gaps. It reports drift, missing decisions, and terminology inconsistencies across system-level and feature-level architecture views with actionable remediation guidance.

What format does the architecture consistency analysis output use?

Architecture conformance analysis validates ADRs against MADR-like criteria and compares them with AD.md to surface quality gaps. It reports drift, missing decisions, and terminology inconsistencies across system-level and feature-level architecture views with actionable remediation guidance.