skills.rest
VitaDynamics
VitaDynamicsOFFICIAL
Explore all skills by this author →
GitHub

adr

Create sequentially numbered Architecture Decision Records in docs/adr/.

Updated Jan 8, 2026
Search Tags:#planning#architecture#documentation#software design#decision record#adr
One-click install
npx skills add https://github.com/VitaDynamics/vita-cc-market --skill adr-vitadynamics
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/VitaDynamics/vita-cc-market/tree/main/plugins/Vengineer/skills/adr
Command: npx skills add https://github.com/VitaDynamics/vita-cc-market --skill adr-vitadynamics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you systematically capture and document architectural decisions, ensuring clarity and maintainability in your projects.

Core Features & Use Cases

  • Automated ADR Generation: Creates sequentially numbered Architecture Decision Records (ADRs) from plans, specs, or descriptions.
  • Structured Documentation: Follows a standard ADR template for consistent record-keeping.
  • Use Case: After deciding on a new database technology for your project, use this Skill to generate a formal ADR documenting the context, decision, alternatives considered, and consequences.

Quick Start

Use the adr skill to record a new architectural decision based on the provided plan file.

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 systematically in my project?▼

Architecture Decision Records are sequentially-numbered documents stored in the docs/adr/ directory that permanently capture context, decisions, alternatives, and consequences from plans or specs.

How do I generate an ADR from an existing plan or spec file?▼

Generate an ADR by providing a plan file, spec file, or inline description; the system automatically determines the next ADR number and creates an updated index file in the docs/adr/ directory.

When should I create an Architecture Decision Record?▼

Create an Architecture Decision Record when you need to permanently capture a significant software design choice, such as selecting a new database technology, ensuring clarity and maintainability across the project.

Does this ADR tool automatically maintain the index file?▼

Yes, the tool automates the determination of the next sequential ADR number and creates an updated index file alongside the new Architecture Decision Record in the documentation directory.

What is the best way to keep architectural documentation consistent?▼

The best way to keep architectural documentation consistent is by following a standard ADR template for record-keeping, ensuring every sequentially-numbered document captures the same structural metadata.

Related Skills

Explore More Software Engineering Skills→
xxihxxih
1

architecture-decision-records

Capture architecture decisions as structured ADR documents in docs/adr.

Community
Intermediate
amoutiersamoutiers
1

x-adr

Draft architectural decision records using adr-template.md and update the ADR index.

Community
Advanced
1479089714790897
7

kwp-engineering-architecture

Create and evaluate Architecture Decision Records documenting technical trade-offs.

Community
Intermediate
garethrhughesgarethrhughes
5

decision-log

Create ADR-formatted decision records and update the decision index.

Community
Intermediate