skills.rest
chaimt
chaimtCOMMUNITY
Explore all skills by this author →
Website𝕏@chaimtGitHub

speckit-adlc-architect-clarify

Analyze MADR-style ADRs against a constitution and generate clarification questions.

Updated Apr 21, 2026
Search Tags:#architecture#documentation#adr#clarification#quality#governance#madr
One-click install
npx skills add https://github.com/chaimt/GarminShabbatMode --skill speckit-adlc-architect-clarify
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-adlc-architect-clarify
Source: https://github.com/chaimt/GarminShabbatMode/tree/main/.cursor/skills/speckit-adlc-architect-clarify
Command: npx skills add https://github.com/chaimt/GarminShabbatMode --skill speckit-adlc-architect-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill helps architecture teams refine MADR-style ADRs by identifying gaps, asking precise clarifying questions, and ensuring completeness before implementation.

Core Features & Use Cases

  • Analyze existing ADRs in {REPO_ROOT}/.specify/drafts/adr.md and cross-check against the constitution to surface missing context, decisions, consequences, and alternatives.
  • Generate targeted clarification prompts that guide authors to fill in gaps, document risks, and align with governance principles.
  • Update ADRs with clarifications while preserving original intent and maintaining traceability.

Quick Start

Initiate the clarify workflow against your ADR drafts to generate targeted clarification questions.

Frequently Asked Questions about speckit-adlc-architect-clarify

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

FAQPage Schema
How do I identify gaps in MADR-style architecture decision records?▼

To identify gaps in MADR-style architecture decision records, you can analyze ADR drafts against a constitution file to surface missing context, decisions, consequences, and alternatives through targeted clarification questions.

What is the best way to ensure ADRs align with governance principles before implementation?▼

The best way to ensure ADRs align with governance principles is cross-checking drafts against a constitution file, generating structured clarification prompts that guide authors to document risks and fill in missing context.

How do I generate targeted clarification questions for incomplete ADR drafts?▼

You generate targeted clarification questions for incomplete ADR drafts by analyzing the existing architecture decision record, checking alignment with governance principles, and outputting structured prompts to resolve missing context and alternatives.

Can I update ADR content with clarifications while preserving the original architecture intent?▼

Yes, you can update ADR content with clarifications while preserving the original architecture intent and maintaining traceability, ensuring the refined document reflects governance alignment without losing the initial context.

What should I do if my ADR drafts are missing alternatives and consequences?▼

If your ADR drafts are missing alternatives and consequences, run a clarification workflow that analyzes the draft against governance principles to produce structured prompts, guiding you to document missing risks and decisions.

Related Skills

Explore More Software Engineering Skills→
tellbomtellbom

speckit-constitution

Synchronize project constitutions with governance principles across templates and memory files.

Community
Advanced
sddevelopment-besddevelopment-be
13

ARCHITECT ADR

Generate Proposed ADR Markdown files with decision sections and impact matrices.

Official
Advanced
fmbetancourtfmbetancourt

speckit-constitution

Automates versioning, placeholder replacement, and consistency validation of project constitution files.

Community
Advanced
GenEducationGenEducation

bmad-document-project

Document existing software projects into structured markdown for AI context.

Official
Advanced