create-architectural-decision-record

Generate ADR documents with standardized front-matter from decision data.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/iliasjennane/LearningAgent --skill create-architectural-decision-record-iliasjennane
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-architectural-decision-record
Source: https://github.com/iliasjennane/LearningAgent/tree/main/.agents/skills/create-architectural-decision-record
Command: npx skills add https://github.com/iliasjennane/LearningAgent --skill create-architectural-decision-record-iliasjennane

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADR drafting is tedious and inconsistent, and this skill automates the creation of Architectural Decision Records to ensure standardized, machine-readable documentation and clear rationale.

Core Features & Use Cases

  • Generate ADR documents from inputs Context, Decision, Alternatives, and Stakeholders.
  • Enforce a standardized ADR front-matter and body to support tooling, review, and future audits.
  • Save ADRs under the project's docs/adr directory with sequential naming and versioning.

Quick Start

Create an ADR for a given decision title by supplying Context, Decision, Alternatives, and Stakeholders.

Frequently Asked Questions about create-architectural-decision-record

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

FAQPage Schema
How do I automate drafting an Architectural Decision Record for my software project?

Automate Architectural Decision Record drafting by providing the decision title, Context, Decision, Alternatives, and Stakeholders to generate a standardized document. This ensures consistent structure, machine-readable front-matter, and clear rationale for downstream tooling and human reviews.

What is the best way to standardize ADR documentation across an engineering team?

Standardize ADR documentation by applying a consistent front-matter template that captures Context, Decision, Alternatives, and Stakeholders. This enforces a uniform structure across all architectural decisions, making them traceable and supporting future audits.

How does an Architectural Decision Record template handle alternatives and stakeholders?

An Architectural Decision Record template handles alternatives and stakeholders by explicitly structuring them into dedicated sections. This ensures every evaluated alternative and involved stakeholder is documented, providing traceable rationale for future reviews.

Can I generate an ADR for AI projects using a standardized template?

You can generate an ADR for AI projects using a standardized template. The process applies to architectural decisions across both AI and software projects, ensuring traceable rationale and consistent structure regardless of the project domain.

Where are generated Architectural Decision Records saved in a project repository?

Generated Architectural Decision Records are saved under the project's docs/adr directory. They use sequential naming and versioning to maintain an organized, auditable history of decisions for downstream tooling and human reviews.