skills.rest
as4584
as4584COMMUNITY
Explore all skills by this author →
WebsiteGitHub

architecture-decision-records

Create and manage Architecture Decision Records with multiple templates.

2|Updated Jan 18, 2026
Search Tags:#architecture#decision making#documentation#software design#adr#technical decisions
One-click install
npx skills add https://github.com/as4584/antigravity-skills --skill architecture-decision-records-as4584
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/as4584/antigravity-skills/tree/main/agents-wshobson/plugins/documentation-generation/skills/architecture-decision-records
Command: npx skills add https://github.com/as4584/antigravity-skills --skill architecture-decision-records-as4584

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires adr-tools, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured framework for documenting significant technical decisions, ensuring clarity, consistency, and maintainability of architectural choices over time.

Core Features & Use Cases

  • ADR Creation: Generate new Architecture Decision Records (ADRs) using various templates (Standard, Lightweight, Y-Statement, Deprecation, RFC).
  • ADR Management: Organize ADRs within a defined directory structure and maintain an index.
  • Lifecycle Tracking: Track the status of decisions (Proposed, Accepted, Deprecated, Superseded, Rejected).
  • Best Practices Enforcement: Provides guidelines and checklists for effective ADR writing and review.
  • Use Case: When deciding on a new database technology for a critical system, use this Skill to create an ADR that captures the context, decision drivers, considered options, the final decision, and its consequences.

Quick Start

Use the architecture-decision-records skill to create a new ADR for 'Adopting TypeScript for Frontend Development'.

Frequently Asked Questions about architecture-decision-records

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

FAQPage Schema
How do I document significant technical decisions for software architecture?▼

Document significant technical decisions by creating Architecture Decision Records (ADRs) that capture context, decision drivers, considered options, the final decision, and consequences. This Skill generates structured ADRs using templates like Standard, Lightweight, or Y-Statement.

What is the best way to track the lifecycle of an architectural decision?▼

Track the lifecycle of an architectural decision by updating its status throughout the review process. This Skill manages lifecycle states including Proposed, Accepted, Deprecated, Superseded, and Rejected within an organized directory index.

How do I create an ADR using adr-tools?▼

Create an ADR using adr-tools by leveraging this Skill's scripts to generate records from multiple templates. It enforces best practices for architectural documentation and manages the directory structure for your technical decisions.

When should I use a lightweight ADR template instead of a standard one?▼

Use a lightweight ADR template for smaller technical decisions that require less context, instead of the standard template for critical system choices. This Skill supports multiple formats to match the scale and complexity of your architectural documentation.

Can I use this Skill to enforce best practices for architectural documentation?▼

Yes, you can enforce best practices for architectural documentation using this Skill. It provides guidelines and checklists for effective ADR writing and review to ensure clarity, consistency, and maintainability of technical choices.

Related Skills

Explore More Software Engineering Skills→
DbillionaerDbillionaer
1

architecture-decision-records

Create and manage Architecture Decision Records using standardized templates.

Community
Intermediate
DavidROliverBADavidROliverBA
49

ADR Report Skill

Generate markdown reports of ADR activity categorized by status and project.

Community
Intermediate
clover-stormclover-storm

sync-docs

Detect code changes from git diffs and update corresponding documentation sections.

Community
Intermediate
bugrabilgebugrabilge
10

architecture-decision-records

Create and manage Architecture Decision Records using multiple templates.

Community
Intermediate