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

Ready to run

npx skills add https://github.com/chaimt/GarminShabbatMode --skill adlc-architect-clarify

💬 Prompt for ChatGPT / Claude Chat▼

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.