skills.rest
SebastienDegodez
SebastienDegodezCOMMUNITY
Explore all skills by this author →
GitHub

architecture-decisions

Create, review, and manage architecture decision records with templates and status tracking.

8|2|Updated Apr 16, 2026
Search Tags:#architecture#software development#document management#decision records#ADRs
One-click install
npx skills add https://github.com/SebastienDegodez/skraft-plugin --skill architecture-decisions-sebastiendegodez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decisions
Source: https://github.com/SebastienDegodez/skraft-plugin/tree/main/plugins/skills/architecture-decisions
Command: npx skills add https://github.com/SebastienDegodez/skraft-plugin --skill architecture-decisions-sebastiendegodez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill manages architecture decision records (ADRs), simplifying the process of documenting, reviewing, and tracking architectural decisions throughout the software development lifecycle.

Core Features & Use Cases

  • ADRs Documentation: Guides users through creating ADRs with templates, ensuring all necessary details are included.
  • Review Process: Automates the review and ratification of ADRs, with built-in checks for completeness and adherence to best practices.
  • Lifecycle Management: Tracks the status and lifecycle of ADRs from Proposed to Accepted, Rejected, Deprecated, or Superseded.

Quick Start

Create a new architecture decision record with 'adr create architecture-decisions-001 My Decision Title'.

Frequently Asked Questions about architecture-decisions

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

FAQPage Schema
How do I automate architecture decision records management?▼

Automating architecture decision records (ADRs) management involves using templates to enforce structure, automating reviews, and tracking statuses from Proposed to Accepted or Superseded throughout the software development lifecycle.

What is the best way to track the lifecycle of an ADR?▼

Tracking the lifecycle of an ADR requires monitoring its status transitions from Proposed to Accepted, Rejected, Deprecated, or Superseded, ensuring decisions are documented and reviewed systematically during software development.

How do I create an architecture decision record with a template?▼

Creating an architecture decision record with a template requires using specific commands to initialize the file, ensuring all necessary architectural details are documented and enforced according to best practices.

Can I automate the review process for ADRs?▼

Automating the review process for ADRs is supported through built-in checks for completeness and adherence to best practices, streamlining the ratification of architectural decisions within your workflow.

Do I need software architecture best practices knowledge to manage ADRs?▼

Understanding software architecture best practices and decision-making workflows is required to effectively manage ADRs, as this knowledge ensures proper documentation, review processes, and lifecycle tracking.

What are the limitations of automated ADR management?▼

Limitations of automated ADR management include its reliance on predefined templates and strict status tracking, meaning it cannot replace the human judgment needed for complex architectural decision-making workflows.

Related Skills

Explore More Software Engineering Skills→
VidyaBodepudiVidyaBodepudi
2

documentation-and-adrs

Manage documentation standards and Architecture Decision Records for software projects.

Community
Intermediate
Sumeet138Sumeet138
1

architecture-decision-records

Document architectural decisions with context, rationale, and status values.

Community
Advanced
ghalacticghalactic
2

adr-skill

Create, maintain, and review Architecture Decision Records in a repository.

Official
Intermediate
adolfoaranaes12adolfoaranaes12
2

create-adr

Create Architecture Decision Records with context, alternatives, rationale, and consequences.

Community
Advanced