skills.rest
cjennings
cjenningsCOMMUNITY
Explore all skills by this author →
Website𝕏@craigjenningsGitHub

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
One-click install
npx skills add https://github.com/cjennings/rulesets --skill arch-decide
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
abdullah1854abdullah1854
1

webapp-testing

Generate Markdown Architectural Decision Records from structured inputs.

Community
Advanced
a53alia53ali

architecture-decision-record

Write, update, and query Architecture Decision Records using Markdown templates.

Community
Intermediate
mikrojsmikrojs
11

documentation-and-adrs

Organizes and archives architectural decisions and project documentation in Markdown files with structured ADR templates.

Official
Basic
yusaduymazyusaduymaz

gsd-thread

Create, list, resume, and close persistent context threads across sessions.

Community
Intermediate