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

adlc-architect-clarify

Identify underspecified areas in ADRs and generate targeted clarification questions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill helps ensure ADRs are complete and consistent by identifying underspecified areas and guiding targeted clarification questions to speed up architecture governance.

Core Features & Use Cases

  • Validate ADR completeness against MADR standards.
  • Identify gaps in consequences or alternatives and detect conflicts between ADRs.
  • Guide interactive refinement through one-question-at-a-time clarifications and updates.
  • Check alignment with constitution principles and cross-ADR consistency.

Quick Start

Begin the clarification workflow by loading the ADR draft set and starting the first targeted clarification.

Frequently Asked Questions about adlc-architect-clarify

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

FAQPage Schema
How do I identify gaps and underspecified areas in architecture decision records?▼

To identify gaps in architecture decision records, you validate ADR completeness against MADR standards to find missing consequences or alternatives. This process detects underspecified areas and conflicts between ADRs to ensure alignment and consistency.

What is the best way to clarify and refine incomplete ADR drafts?▼

The best way to clarify incomplete ADR drafts is through interactive refinement using targeted, actionable questions. Generating clarifying prompts one question at a time guides architecture governance and updates the ADR repository effectively.

How do I check if my ADRs align with constitution principles and cross-ADR consistency?▼

Checking ADR alignment involves validating your drafts against constitution principles and cross-referencing related decisions. This detects conflicts between ADRs, ensuring cross-ADR consistency and strict alignment with established governance guidelines.

Can I use targeted clarification questions to speed up architecture governance?▼

Yes, you can speed up architecture governance by applying targeted clarification questions to your ADRs. This interactive refinement process identifies underspecified areas one question at a time, ensuring complete and consistent documentation efficiently.

What are the limitations of using automated clarification for ADR quality checklists?▼

Automated ADR clarification requires access to the ADR repository and the ADR quality checklist. Limitations include the need for existing drafts under .specify/drafts and the inability to generate updates without an accessible constitution guidance baseline.

Related Skills

Explore More Software Engineering Skills→
chaimtchaimt

speckit-adlc-architect-clarify

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

Community
Advanced
subroh0508subroh0508
18

adr-author

Drafts numbered ADRs and updates the index with cross-links and eligibility checks.

Community
Advanced
chaimtchaimt

architect-clarify

Identify underspecified areas in ADRs and refine them through targeted clarification questions.

Community
Advanced
DomainLangDomainLang
16

software-architect

Create and inspect ADRs and PRSs with DDD alignment.

Official
Advanced