adr-new

Name: adr-new
Availability: InStock
Author: natecostello

Generate new Architecture Decision Records from a standard template.

Updated Aug 27, 2026

Search Tags:#architecture #templates #documentation #engineering #ADR #decision-making

Ready to run

npx skills add https://github.com/natecostello/agent-skills --skill adr-new

💬 Prompt for ChatGPT / Claude Chat▼

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.