skills.rest
richardnguyen0715
richardnguyen0715COMMUNITY
Explore all skills by this author →
GitHub

develop-adr

Document technical decisions in the Nygard ADR format.

Updated May 20, 2026
Search Tags:#knowledge management#system design#software architecture#architecture decision record#technical decision documentation
One-click install
npx skills add https://github.com/richardnguyen0715/ai-chatting-app --skill develop-adr-richardnguyen0715
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: develop-adr
Source: https://github.com/richardnguyen0715/ai-chatting-app/tree/main/.github/skills/develop-adr
Command: npx skills add https://github.com/richardnguyen0715/ai-chatting-app --skill develop-adr-richardnguyen0715

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you create Architecture Decision Records (ADR) to document significant technical decisions, ensuring clear communication and knowledge preservation.

Core Features & Use Cases

  • Document Technical Decisions: Capture the context, decision, and consequences of technical choices.
  • Follow Nygard Format: Use the established Nygard format for consistency and ease of understanding.
  • Use Case: When deciding between different database technologies, use this Skill to document the rationale, the decision, and the expected consequences.

Quick Start

To start creating an ADR, run the following command: create-adr "Use PostgreSQL for our order database".

Frequently Asked Questions about develop-adr

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 for software architecture?▼

Yes, you can document any technical decision by running the create-adr command with your specific topic, such as selecting a database technology or choosing a system design pattern.

How do I document technical decisions and their impact for my system design?▼

You document technical decisions by running the create-adr command with your topic. This generates an Architecture Decision Record capturing the context, decision, and expected consequences for your software architecture.

What format does this use for technical decision documentation?▼

This uses the established Nygard ADR format for consistency and ease of understanding. The Nygard format structures your technical decision documentation to emphasize context, the decision-making process, and consequences.

Do I need any dependencies to create an Architecture Decision Record?▼

No dependencies are required to create an Architecture Decision Record. You can start capturing and documenting your software architecture decisions immediately without setting up additional environments or installing external tools.

Can I use this to document database technology choices?▼

Yes, you can document database technology choices. When deciding between different database technologies, this skill captures the rationale, the final decision, and the expected consequences for knowledge management.

Related Skills

Explore More Software Engineering Skills→
majesticlabs-devmajesticlabs-dev
47

create-adr

Create standardized Architecture Decision Records with a versioned naming convention.

Official
Advanced
imgamerimgamer

architecture-decision

Create Architecture Decision Records with context, alternatives, and consequences.

Community
Advanced
stevolandstevoland

adr

Create and manage MADR-compliant Architecture Decision Records across projects.

Community
Basic
product-on-purposeproduct-on-purpose
527

develop-adr

Generate Architecture Decision Records using the Nygard-style ADR template.

Official
Basic