wr-architect:create-adr

Create MADR 4.0 Architecture Decision Records in docs/decisions.

4|1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/windyroad/agent-plugins --skill wr-architect-create-adr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wr-architect:create-adr
Source: https://github.com/windyroad/agent-plugins/tree/main/packages/architect/skills/create-adr
Command: npx skills add https://github.com/windyroad/agent-plugins --skill wr-architect-create-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create MADR 4.0 Architecture Decision Records to document and standardize architectural decisions within a project, ensuring traceability and governance.

Core Features & Use Cases

  • Interactive context gathering: prompts for decision context using a structured questionnaire.
  • ADR generation: writes a MADR 4.0 conformant ADR in docs/decisions/ with proper frontmatter and sections.
  • Decision governance: supports linking, reassessment scheduling, and provenance for decisions.

Quick Start

Prompt for decision context and generate a MADR 4.0 ADR in docs/decisions/.

Frequently Asked Questions about wr-architect:create-adr

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

FAQPage Schema
How do I create MADR 4.0 architecture decision records?

To create MADR 4.0 architecture decision records, use interactive context gathering to capture decision drivers and options, then automatically generate a properly formatted ADR file in the docs/decisions directory.

What is an architecture decision record used for in software governance?

An architecture decision record is used in software governance to capture, standardize, and document architectural decisions, ensuring traceability and structured provenance for team discussions and decision outcomes.

How do I document architectural drivers and consequences in an ADR?

You document architectural drivers and consequences by responding to a structured questionnaire that gathers context, options, and decision outcomes, which are then automatically formatted into the final ADR.

Can I schedule reassessments for recorded architecture decisions?

Yes, you can schedule reassessments for recorded architecture decisions because the system supports decision governance features, including linking related records and tracking provenance for future evaluations.

What is the best way to standardize architecture documentation across a project?

The best way to standardize architecture documentation is to enforce a consistent MADR 4.0 format with required metadata, context, drivers, options, and decision outcomes stored in a centralized docs/decisions directory.

Does this ADR generation process work without external dependencies?

Yes, the ADR generation process works without external dependencies, using an internal interactive workflow to validate context and output compliant architecture decision records directly.