architecture-decision-records

Automate creation and lifecycle management of Architecture Decision Records in Markdown.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-yaml, python-markdown-markdown, m2crypto, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill facilitates the streamlined documentation of Architecture Decision Records (ADRs), ensuring best practices are followed for technical decision documentation and onboarding.

Core Features & Use Cases

  • ADRs Documentation: Captures the context, rationale, and consequences of significant technical decisions.
  • Documentation Patterns: Provides templates for creating and maintaining ADRs in Markdown format.
  • Use Case: Implement ADRs in projects where multiple decisions are made frequently, improving maintainability and promoting transparency.

Quick Start

Initialize your Architecture Decision Records documentation and template.

Frequently Asked Questions about architecture-decision-records

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

FAQPage Schema
How do I automate architecture decision record documentation in Markdown?

You can automate architecture decision record documentation by using templates to capture context, rationale, and consequences. This Skill processes Markdown and YAML to maintain ADRs, ensuring technical decisions follow industry standards like ADR-MADR for clarity and compliance.

What is the best way to track architecture decisions for technical onboarding?

Tracking architecture decisions for onboarding involves recording the context and consequences of significant technical choices. This Skill provides documentation patterns and templates to maintain these records, improving project transparency and maintainability for new team members.

How does an ADR lifecycle management process work for software engineering projects?

ADR lifecycle management works by automating the creation, maintenance, and tracking of architecture decision records. It applies technical documentation best practices to ensure every significant decision is consistently documented using Markdown templates and YAML parsing.

Can I use YAML parsing and Markdown processing for architecture decision tracking?

Yes, architecture decision tracking can utilize YAML parsing and Markdown processing. This Skill requires these dependencies to initialize templates, apply documentation patterns, and manage the lifecycle of ADRs effectively within your project.

Does this approach ensure compliance with ADR-MADR industry standards?

Yes, this approach ensures compliance with ADR-MADR standards. By applying these industry standards to your architecture decision tracking, the Skill guarantees that your technical documentation maintains consistency and follows established best practices.

When do I need to implement architecture decision records in my project?

You need to implement architecture decision records when your project involves frequent significant technical decisions. Using ADRs captures the context and rationale behind these choices, improving maintainability and promoting transparency across the engineering team.