skills.rest
Donchitos
DonchitosCOMMUNITY
Explore all skills by this author →
GitHub

architecture-decision

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

23.7k|3.4k|Updated Feb 12, 2026
Search Tags:#architecture#documentation#decision record#adr#technical documentation
One-click install
npx skills add https://github.com/Donchitos/Claude-Code-Game-Studios --skill architecture-decision-donchitos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision
Source: https://github.com/Donchitos/Claude-Code-Game-Studios/tree/main/.claude/skills/architecture-decision
Command: npx skills add https://github.com/Donchitos/Claude-Code-Game-Studios --skill architecture-decision-donchitos

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps maintain a clear and organized record of significant technical decisions made within a project, ensuring that the reasoning behind architectural choices is preserved and accessible.

Core Features & Use Cases

  • Generate ADRs: Creates Architecture Decision Records (ADRs) following a standardized template.
  • Numbering and Formatting: Automatically determines the next ADR number and formats the output correctly.
  • Use Case: When deciding to switch from a monolithic architecture to microservices, use this skill to create an ADR that details the context, alternatives considered, the final decision, and its consequences.

Quick Start

Use the architecture-decision skill to create a new ADR titled "Implement Caching Layer".

Frequently Asked Questions about architecture-decision

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 to document one?▼

An Architecture Decision Record (ADR) documents significant technical decisions, capturing context, alternatives, and consequences. You need an ADR when making architectural choices like switching from a monolithic architecture to microservices to preserve project reasoning.

How do I generate an ADR for a new technical decision?▼

To generate an ADR, provide a title like "Implement Caching Layer." The skill scans existing ADRs for numbering, automatically determines the next ADR number, and guides you through documenting context, alternatives, the decision, and consequences.

Does this ADR generator scan my existing decision records for numbering?▼

Yes, the ADR generator scans existing Architecture Decision Records in your project to automatically determine the next ADR number and formats the output correctly, ensuring your technical documentation remains organized.

What is the best way to document architectural choices and their consequences?▼

The best way to document architectural choices is using an ADR following a standardized template. This records the context, alternatives considered, final decision, and consequences, ensuring the reasoning behind technical choices is preserved and accessible.

Can I use this to document a decision to switch from monolithic to microservices architecture?▼

Yes, you can use this skill to create an ADR detailing the context, alternatives considered, final decision, and consequences of switching from a monolithic architecture to microservices, maintaining a clear and organized record.

What sections are included in a standardized Architecture Decision Record template?▼

A standardized Architecture Decision Record template includes sections for context, alternatives considered, the final decision, and consequences, ensuring significant technical decisions and their reasoning are thoroughly documented.

Related Skills

Explore More Software Engineering Skills→
wanghaishengwanghaisheng
10

architecture-decision

Generate Architecture Decision Records documenting context, alternatives, and consequences.

Community
Intermediate
microsoftmicrosoft
2.9k

wiki-vitepress

Package wiki Markdown into a VitePress static site with dark theme and Mermaid diagrams.

Official
Advanced
Harvest-Forged-CodeHarvest-Forged-Code
10

documentation-generator

Generate and update project documentation from codebase exploration.

Official
Advanced
mvillmowmvillmow
18

doc-generate-adr

Generate Architecture Decision Records with structured Context, Decision, Rationale, and Consequences.

Community
Basic