skills.rest
leocosta
leocostaCOMMUNITY
Explore all skills by this author →
𝕏@leoccostaGitHub

doc-adr

Create MADR-compliant ADR files with lifecycle governance and numbering.

4|Updated Mar 21, 2026
Search Tags:#workflow#architecture#documentation#adr#governance#architecture-decision#madr
One-click install
npx skills add https://github.com/leocosta/octopus --skill doc-adr-leocosta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-adr
Source: https://github.com/leocosta/octopus/tree/main/skills/doc-adr
Command: npx skills add https://github.com/leocosta/octopus --skill doc-adr-leocosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ADRs provide a structured, auditable record of architectural decisions to prevent knowledge loss and misalignment across teams.

Core Features & Use Cases

  • MADR-compliant structure: standardizes recording context, decision, alternatives, and consequences.
  • Lifecycle governance: supports creation, review, superseding decisions, and indexing for traceability.
  • Use Case: when choosing between technologies, draft an ADR to capture reasoning and outcomes.

Quick Start

Create a new ADR file in docs/adrs/ following the 3-digit numbering scheme and fill all sections.

Frequently Asked Questions about doc-adr

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

FAQPage Schema
How do I document architectural decisions to prevent knowledge loss across teams?▼

Architectural decisions are documented using ADRs to provide a structured, auditable record that prevents knowledge loss and misalignment across teams. This Skill guides you through creating MADR-compliant ADRs capturing context, alternatives, and consequences.

What is the MADR format for architecture decision records?▼

The MADR format standardizes architecture decision records by enforcing a compliant structure that consistently records context, decision, alternatives, and consequences, ensuring traceability and consistent naming through a lifecycle workflow.

How do I supersede an old architectural decision when choosing a new technology?▼

To supersede an old architectural decision, this Skill enforces a lifecycle governance workflow that supports creating, reviewing, and superseding decisions across systems while maintaining indexing for full traceability.

How do I structure ADR files for governance and versioning?▼

ADR files are structured for governance and versioning by placing them in docs/adrs/ following a 3-digit numbering scheme, filling all MADR-compliant sections to ensure consistent naming and lifecycle governance.

When should I use ADRs over standard documentation for software architecture?▼

Use ADRs over standard documentation when you need an auditable record of architectural decisions to prevent miscommunication, such as when choosing between technologies and needing to capture reasoning and outcomes.

Related Skills

Explore More Software Engineering Skills→
mrdavidlaingmrdavidlaing
3

yak-adr

Create, supersede, amend, and index Architecture Decision Records in docs/adr.

Community
Advanced
SSiertsemaSSiertsema

adr-writing

Document architecture decisions with ADR-NNN IDs and lifecycle states.

Community
Advanced
rodmena-limitedrodmena-limited
3

moai-foundation-claude

Create, configure, and manage Claude Code Skills with templates and tools.

Official
Advanced
loianeloiane
50

adr-authoring

Document MADR-style Architecture Decision Records with required sections.

Community
Intermediate