skills.rest
rlagycks
rlagycksCOMMUNITY
Explore all skills by this author →
GitHub

architecture-decision-records

Create and update architecture decision records using standard templates.

3|Updated Apr 9, 2026
Search Tags:#architecture#documentation#decisions#knowledge management#software design#system architecture
One-click install
npx skills add https://github.com/rlagycks/oh-my-forge --skill architecture-decision-records-rlagycks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/rlagycks/oh-my-forge/tree/main/skills/architecture-decision-records
Command: npx skills add https://github.com/rlagycks/oh-my-forge --skill architecture-decision-records-rlagycks

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps developers systematically record and organize architectural decisions to improve project transparency and knowledge sharing.

Core Features & Use Cases

  • Automated ADR Logging: Detects decision points during coding or discussions and prompts for documentation.
  • ADR Management: Creates, updates, and references ADRs following a standard format.
  • Use Case: During system design, a developer confidently records the choice of database technology, complete with context and alternatives, ensuring traceability.

Quick Start

Ask the AI to document a recent architectural decision, and it will generate or update the relevant ADR files accordingly.

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 software architecture decisions for better traceability?▼

Documenting architecture decisions involves recording context, alternatives, and chosen solutions to ensure traceability. This skill facilitates structured recording across development phases using standard templates and indexing standards.

What is the best way to manage architecture decision records during system design?▼

Managing architecture decision records is best handled by creating, updating, and referencing decisions following a standard format. This skill automates logging by detecting decision points during discussions and prompting for documentation.

Can I automatically generate architecture documentation from coding discussions?▼

Automatically generating architecture documentation is possible by detecting decision points during coding or discussions. This skill prompts for documentation and generates or updates relevant ADR files to maintain consistency.

Does this approach to recording architectural decisions work for team collaboration?▼

Recording architectural decisions effectively supports team collaboration and documentation consistency. This skill ensures ADRs follow established templates and indexing standards, improving project transparency and knowledge sharing.

When do I need to create an architecture decision record in software projects?▼

You need to create an architecture decision record whenever a significant system architecture choice is made, such as selecting a database technology. Recording decisions during development ensures project transparency and decision traceability.

What format should I use for documenting software design choices?▼

Documenting software design choices should follow established ADR templates and indexing standards to ensure consistency. This skill structures architectural decisions with complete context and alternatives for comprehensive knowledge management.

Related Skills

Explore More Content & Communication Skills→
caobingshengcaobingsheng
1

docs-writer

Write and edit Markdown documentation following Gemini CLI project standards.

Community
Intermediate
Happy-Technologies-LLCHappy-Technologies-LLC
34

adr-summarization

Summarize Architecture Decision Records from ServiceNow into executive-ready narratives.

Official
Advanced
atilladenizatilladeniz
2

system-design

Generate Mermaid diagrams for system design and architecture visualization.

Community
Basic
EngineerWithAIEngineerWithAI
4

architecture-decision-records

Create and manage Architecture Decision Records in multiple formats.

Official
Intermediate