ADR Format

Create standardized markdown templates for recording architecture decisions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Ermianr/meteor --skill adr-format-ermianr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ADR Format
Source: https://github.com/Ermianr/meteor/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/Ermianr/meteor --skill adr-format-ermianr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the process of creating and maintaining Architecture Decision Records by providing a standard, lightweight markdown template and guidelines.

Core Features & Use Cases

  • Structured ADR Creation: Guides users to document decisions clearly with minimal effort.
  • Template Guidance: Offers a standardized format to encourage consistency across ADRs.
  • Use Case: When documenting new technology choices, quickly create ADRs aligned with team standards to improve traceability.

Quick Start

Use the ADR skill to generate a new ADR documenting a recent architectural decision efficiently.

Frequently Asked Questions about ADR Format

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

FAQPage Schema
What is an architecture decision record and when do I need one?

An architecture decision record documents key technical trade-offs and design choices to maintain decision traceability across projects. You need an ADR when selecting new technologies or making structural design choices that require clear, consistent documentation.

How do I format architecture decisions in markdown for consistent documentation?

To format architecture decisions in markdown, use a standardized template that structures the context, decision, and consequences. This lightweight format ensures consistent documentation and improves traceability across technical project files.

What's the best way to start documenting architectural decisions for a technical team?

The best way to start documenting architectural decisions is applying a standardized markdown template to record trade-offs and design choices. This ensures team alignment and creates a traceable history of architectural decisions with minimal effort.

Can I use this ADR template for documenting any new technology choice?

Yes, you can use this ADR template for documenting new technology choices. It guides technical teams to clearly record architectural decisions and design trade-offs, ensuring decisions are traceable and aligned with team documentation standards.

Do I need any specific dependencies to generate architecture decision records?

No dependencies are required to generate architecture decision records. This skill provides a lightweight markdown template and formatting guidelines directly, allowing you to document architectural decisions without external tool installations.

Why does my team need a standardized template for architecture decision records?

Your team needs a standardized template for architecture decision records to prevent fragmented documentation and lost context. Consistent markdown formatting ensures architectural decisions and trade-offs remain traceable and easily understandable across all projects.