architect-clarify

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADR clarification is needed to surface gaps in existing ADRs, ensure explicit decisions, and guide architectural governance through targeted questions that resolve ambiguity and align with project principles.

Core Features & Use Cases

  • Identify underspecified areas in ADRs and prompt for focused clarifications
  • Enforce one-question-at-a-time interaction to drive precise improvements
  • Validate ADRs against MADR-like standards and constitution constraints
  • Support interactive refinement with change-tracking and document hygiene

Quick Start

Run /architect.clarify in the repository root to begin ADR clarification.

Frequently Asked Questions about architect-clarify

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

FAQPage Schema
How do I identify gaps in existing Architecture Decision Records?

To identify gaps in existing Architecture Decision Records, you can analyze them against MADR-like quality criteria to surface underspecified areas and prompt for focused, one-question-at-a-time clarifications that resolve ambiguity.

What is the best way to refine ADRs through targeted clarification questions?

The best way to refine ADRs through targeted clarification questions is to enforce an interactive, one-question-at-a-time workflow that preserves the original intent while validating against project constitution constraints and cross-ADR consistency.

How do I ensure architectural governance alignment when updating ADRs?

To ensure architectural governance alignment when updating ADRs, you validate the documents against constitution constraints and cross-ADR consistency rules, recording all changes with timestamps to maintain document hygiene.

Can I validate existing ADRs against MADR-like quality standards?

Yes, you can validate existing ADRs against MADR-like quality standards by analyzing the documents to find ambiguities and checking for explicit decisions that align with project principles.

How do I start an interactive ADR clarification session in my repository?

To start an interactive ADR clarification session in your repository, run the /architect.clarify command in the repository root to begin analyzing and refining your architecture decisions.