skills.rest
natecostello
natecostelloCOMMUNITY
Explore all skills by this author →
GitHub

adr-new

Generate new Architecture Decision Records from a standard template.

Updated Aug 27, 2026
Search Tags:#architecture#templates#documentation#engineering#ADR#decision-making
One-click install
npx skills add https://github.com/natecostello/agent-skills --skill adr-new
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-new
Source: https://github.com/natecostello/agent-skills/tree/main/skills/adr-new
Command: npx skills add https://github.com/natecostello/agent-skills --skill adr-new

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill simplifies the creation and management of Architecture Decision Records (ADRs), ensuring consistent documentation for technical decisions.

Core Features & Use Cases

  • Automated ADR Creation: Generates new ADR files based on a comprehensive template, reducing manual effort.
  • Project Consistency: Ensures ADRs follow a standard format and are correctly indexed.
  • Use Case: When a team makes a new architectural choice, this Skill automates drafting and organizing the ADR for easy reference and approval.

Quick Start

Use the adr-new skill to generate a new architecture decision record with the title "Adopt GraphQL API".

Frequently Asked Questions about adr-new

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

FAQPage Schema
How do I create an Architecture Decision Record for a new software project choice?▼

To create an Architecture Decision Record, you need a standardized template that captures context, decision, and status. This Skill generates structured ADR files automatically, ensuring consistent formatting and indexing for technical decision transparency.

What is the best way to maintain consistent ADR documentation across an engineering team?▼

Maintaining consistent ADR documentation requires enforcing a standard format and updating a central index whenever decisions are made. This Skill standardizes architectural records, applying templates to ensure all engineering choices are uniformly documented and easily referenced.

When do I need to document architectural decisions in my codebase?▼

You need to document architectural decisions whenever your team makes a significant technical choice that impacts project structure. Using ADRs provides version-controlled records of these decisions, ensuring future team members understand the rationale behind specific engineering approaches.

Can I use a template to standardize architecture decision records for version control?▼

Yes, using a template is essential for standardizing architecture decision records in version control. This Skill applies a comprehensive template to generate new ADR files, ensuring formatting adherence and correct index updates for reliable version-controlled tracking.

Does this ADR tool work without any external dependencies or setup?▼

Yes, this ADR creation tool operates with no external dependencies, using only built-in scripts and references. It functions independently to draft and organize architecture decision records, making it easy to integrate into existing software engineering workflows.

Related Skills

Explore More Software Engineering Skills→
lozitlozit
2

add-adr

Create Architecture Decision Records and update the project ADR index.

Community
Intermediate
xloxn69xloxn69
7

agileflow-adr

Convert discussed architectural decisions into MADR-formatted ADR files.

Community
Basic
JongsixJongsix

moai-docs-generation

Generate technical documentation from source code and API definitions.

Community
Advanced
thktthkt
11

creating-adrs

Generate MADR-format Architecture Decision Records through a six-phase workflow.

Community
Advanced