draft-adr

Draft Architecture Decision Records through a one-question-per-message workflow.

12|Updated Apr 19, 2026

Search Tags:#adr #architecture-decision #adl #architecture-contract #co-think #one-question

Ready to run

npx skills add https://github.com/janmohammadi/deep-adr --skill draft-adr-janmohammadi

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: draft-adr
Source: https://github.com/janmohammadi/deep-adr/tree/main/skills/draft-adr
Command: npx skills add https://github.com/janmohammadi/deep-adr --skill draft-adr-janmohammadi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drafts Architecture Decision Records (ADRs) through a disciplined one-question-per-message back-and-forth, ensuring reasoning is explicit and verifiable.

Core Features & Use Cases

One-question-per-message workflow to co-think through decisions with the architect
Reads discovery briefs to avoid re-asking already confirmed facts
Produces an ADL-based Architecture Contract when a decision creates enforceable assertions
Self-critiques before saving to improve decision quality

Quick Start

Start the ADR drafting session by providing the system context and your initial decision focus.

Frequently Asked Questions about draft-adr

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

FAQPage Schema

How do I draft an Architecture Decision Record collaboratively?▼

You draft an Architecture Decision Record through a one-question-per-message workflow, co-thinking with an architect to ensure explicit reasoning before saving.

What is the best way to document architectural decisions for governance?▼

Documenting architectural decisions through an ADL-based Architecture Contract improves traceability, accountability, and governance when choices create enforceable assertions.

How does the one-question workflow work for architecture decisions?▼

The workflow guides you through a Phase 1-7 process, asking one question per message to make reasoning verifiable and avoid re-asking confirmed facts from discovery briefs.

When do I need an Architecture Contract instead of just an ADR?▼

You need an Architecture Contract when an architectural decision creates enforceable assertions, whereas ADRs are saved for general review and future refactorings.

Can I use existing discovery briefs when drafting architecture decisions?▼

Yes, the drafting process reads discovery briefs to avoid re-asking already confirmed facts, streamlining the ADR creation session.

Does the architecture decision workflow self-critique before saving?▼

Yes, the system self-critiques decisions before saving to improve decision quality and ensure explicit, verifiable reasoning.