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.