adr

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

Updated Aug 27, 2026

Search Tags:#documentation #adr #governance #review #team-collaboration #architecture-decision #engineering-process

Ready to run

npx skills add https://github.com/cuongnm-dev/team-ai-config --skill adr-cuongnm-dev

💬 Prompt for ChatGPT / Claude Chat▼

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.