arch-decide

Create architectural decision records using multiple ADR templates and lifecycle tracking.

Updated Aug 23, 2026

Search Tags:#architecture #templates #documentation #adr #architecture-decision #decision-record #adr-tools

Ready to run

npx skills add https://github.com/cjennings/rulesets --skill arch-decide

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: arch-decide
Source: https://github.com/cjennings/rulesets/tree/main/arch-decide
Command: npx skills add https://github.com/cjennings/rulesets --skill arch-decide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architects and engineering teams need a robust, centralized way to record, organize, and evolve architectural decisions to keep projects aligned and auditable.

Core Features & Use Cases

Five ADR templates (MADR, Nygard, Y-statement, lightweight, RFC) to fit diverse decision contexts.
Lifecycle management (Proposed → Accepted → Deprecated / Superseded) and formal review workflows to ensure governance.
adr-tools automation and cross-team collaboration to streamline documentation and traceability.

Quick Start

Create a new ADR by selecting a template, providing context, stating the decision, and outlining consequences.

Frequently Asked Questions about arch-decide

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

FAQPage Schema

What is an architecture decision record and when do I need one?▼

An architecture decision record (ADR) documents significant design choices in a structured, versioned format. You need ADRs whenever capturing architectural decisions to keep projects aligned, auditable, and communicated across teams.

How do I create a new architecture decision record using different templates?▼

To create an architecture decision record, select one of five templates (MADR, Nygard, Y-statement, lightweight, or RFC), provide context, state the decision, and outline consequences to capture architectural choices.

Can I track the lifecycle of an architecture decision record from proposed to accepted?▼

Yes, architecture decision records support lifecycle management tracking statuses from Proposed to Accepted, and eventually Deprecated or Superseded, ensuring formal governance and review workflows.

Does this ADR workflow support adr-tools automation for documentation?▼

Yes, the architecture decision record workflow supports adr-tools automation to streamline documentation processes, enhance traceability, and facilitate cross-team collaboration.

What is the best way to manage architectural decisions across multiple project teams?▼

The best way to manage architectural decisions across teams is using a centralized system with standardized ADR templates, lifecycle tracking, and review workflows to ensure projects remain aligned and decisions are auditable.