architecture-decision-records

Document architectural decisions in markdown with context, decision, alternatives, and consequences.

3|2|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/woxiangyangzhimao/skills --skill architecture-decision-records-woxiangyangzhimao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/woxiangyangzhimao/skills/tree/main/architecture-decision-records
Command: npx skills add https://github.com/woxiangyangzhimao/skills --skill architecture-decision-records-woxiangyangzhimao

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a framework for real-time capture and documentation of architecture decisions during code sessions, ensuring clear documentation and accountability for future reference.

Core Features & Use Cases

  • Real-time Decision Documentation: Captures architecture decisions as they occur during development.
  • Structured ADR Format: Follows a specific format to record the context, decision, alternatives, and consequences.
  • Decision追溯: Allows future reference and understanding of why certain decisions were made.

Quick Start

Record the architecture decision "We choose to use X over Y due to Z reasons" by typing 'adr this'.

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 architecture decisions during code development sessions?

To document architecture decisions during code development sessions, you can capture them in real-time using a structured markdown format. This records context, decision, alternatives, and consequences directly as they occur, ensuring traceability and accountability for future reference.

What is the standard structure for architecture decision records in software development?

The standard structure for architecture decision records includes specific markdown sections for context, decision, alternatives, and consequences. This structured ADR format emphasizes clarity and traceability for the decision-making process in software projects.

What's the best way to track why certain software architecture decisions were made?

The best way to track why software architecture decisions were made is utilizing real-time decision documentation. It allows future reference and understanding by capturing the context, alternatives, and consequences at the moment the decision occurs during development.

Can I capture code review architecture decisions as they happen without interrupting my workflow?

Yes, you can capture architecture decisions as they happen without interrupting your workflow. By using quick commands during code sessions, you can immediately record decisions with context, alternatives, and consequences in real-time markdown documentation.

When do I need to start documenting architecture decisions in my software project?

You need to start documenting architecture decisions as soon as they occur during code development sessions. Capturing context, alternatives, and consequences in real-time prevents loss of rationale and ensures immediate accountability for future reference.

Does real-time architecture decision tracking require external dependencies?

Real-time architecture decision tracking does not require external dependencies. It operates independently using scripts and references to generate structured markdown documentation, capturing context, decisions, alternatives, and consequences directly within your software development process.