adr

Create Architecture Decision Records with structured prompts and automatic ID generation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/cuongnm-dev/team-ai-config --skill adr-cuongnm-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/cuongnm-dev/team-ai-config/tree/main/cursor/skills/adr
Command: npx skills add https://github.com/cuongnm-dev/team-ai-config --skill adr-cuongnm-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture Decision Records help teams capture critical decisions to preserve context and rationale for future reference.

Core Features & Use Cases

  • Standardized ADR templates for full and quick decision modes
  • Structured prompts to capture title, context, decision, alternatives, consequences
  • Simple workflow to generate and store ADR documents with consistent naming

Quick Start

Provide a new Architecture Decision Record by answering the prompts for title, context, decision, alternatives, and consequences.

Frequently Asked Questions about adr

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

FAQPage Schema
How do I document architectural decisions for my engineering team?▼

Create Architecture Decision Records to capture critical decisions by providing a title, context, decision, alternatives, and consequences. This preserves the rationale and context for future reference and team collaboration.

What is the difference between full and quick ADR modes?▼

Full ADR mode requires Software Architect and Tech Lead validation for critical architectural decisions, while quick mode is a solo process for smaller scope decisions that still generates a structured ADR document.

What structure does an Architecture Decision Record need to follow?▼

An Architecture Decision Record requires structured frontmatter followed by sections for title, context, decision, alternatives, consequences, and related items to ensure consistent engineering governance and review.

How do I generate an ADR document with an automatic id?▼

Generate an ADR document by answering workflow prompts for context and decisions; the system automates id generation and applies a standardized template for consistent naming and storage.

When do I need to write an Architecture Decision Record?▼

Write an Architecture Decision Record when making critical architectural decisions that impact engineering processes and require team collaboration, ensuring the context and alternatives are preserved for future governance review.