skills.rest
wanghaisheng
wanghaishengCOMMUNITY
Explore all skills by this author →
Website𝕏@edwin_uestcGitHub

architecture-decision

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

10|2|Updated Mar 11, 2026
Search Tags:#architecture#decision making#documentation#knowledge management#adr#technical debt
One-click install
npx skills add https://github.com/wanghaisheng/OpenAgenticGame-Studios --skill architecture-decision-wanghaisheng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision
Source: https://github.com/wanghaisheng/OpenAgenticGame-Studios/tree/main/refenrece/skills/architecture-decision
Command: npx skills add https://github.com/wanghaisheng/OpenAgenticGame-Studios --skill architecture-decision-wanghaisheng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams formally document significant technical decisions, ensuring clarity, traceability, and shared understanding of architectural choices.

Core Features & Use Cases

  • Formal Documentation: Creates Architecture Decision Records (ADRs) in a standardized format.
  • Decision Tracking: Maintains a history of technical choices, their rationale, and consequences.
  • Use Case: When deciding to adopt a new database technology, use this skill to create an ADR that outlines the problem, the chosen solution, alternatives considered, and the expected impact.

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
How do I document architecture decisions to track technical debt?▼

Document architecture decisions by generating an Architecture Decision Record (ADR) that captures context, alternatives, and consequences. This provides traceability for technical debt and knowledge management within software projects.

What is an Architecture Decision Record used for in software engineering?▼

An Architecture Decision Record (ADR) is used to document significant technical choices in a standardized format. It ensures clarity, shared understanding, and tracks the rationale and consequences of architectural decisions within a project.

How do I create a new ADR following a predefined Markdown template?▼

To create a new ADR, use the skill to scan existing ADRs for correct numbering and adhere to a predefined Markdown template. This structures the document with the problem, chosen solution, and expected impact.

When do I need to write an Architecture Decision Record?▼

You need to write an Architecture Decision Record when making significant technical choices, such as adopting a new database technology or implementing a caching layer, to formally outline the problem and expected impact.

Does this ADR generation process scan existing records for numbering?▼

Yes, the ADR generation process scans existing Architecture Decision Records to determine the correct sequential numbering. This ensures new documentation integrates properly into the project's history.

Related Skills

Explore More Software Engineering Skills→
CygnusfearCygnusfear
5

the-archivist

Document engineering decisions as ADRs with rationale and decision logs.

Community
Advanced
seagetchseagetch

shorts-reader-maintainer

Maintain the shared short-story reader and generation flow in the chatgpt-shorts repository.

Community
Intermediate
abhishekdutta18abhishekdutta18

architecture-decision-records

Create structured architecture decision records in markdown files.

Community
Intermediate
vanillaflavavanillaflava
59

wiki-crystallize

Transform user-generated conversation content into structured wiki pages on the local filesystem.

Community
Intermediate