Can I track changes to old decisions?

Yes, the skill supports status tracking, allowing you to mark decisions as Superseded or Deprecated when new records are created to replace them.

How does this skill automate ADR management?

The skill generates standardized Markdown templates, helps organize them in a dedicated directory, and provides tools to update their status as decisions evolve.

Why should I use ADRs in my project?

ADRs provide essential context for future maintainers, explaining why certain paths were taken and preventing the accidental reversal of intentional architectural choices.

What is an Architectural Decision Record (ADR)?

An ADR is a short document that captures a significant architectural decision, including the context in which it was made and the consequences it has for the project.

Architectural Decision Records

Name: Architectural Decision Records
Author: Agentient

byAgentient

0•

Collaboration Tools

Document and track technical design choices using standardized Markdown ADR templates and lifecycle management.

The Architectural Decision Records skill formalizes the technical decision-making process by automating the creation and management of ADRs within your codebase. It provides a structured framework to capture the context, rationale, and consequences of architectural choices, ensuring that the 'why' behind your code is never lost. By managing decision statuses—from proposed to superseded—and enabling cross-referencing between records, this skill helps maintain a clear historical narrative of a project's evolution, improving team alignment and simplifying future audits or onboarding.

Key Features

01Decision status tracking (Proposed, Accepted, Deprecated, Superseded)

020 GitHub stars

03Automated ADR template generation in Markdown format

04Cross-referencing capabilities for related architectural decisions

05Standardized workflow for reviewing and updating decision history

06Structured impact analysis documentation for technical changes

Use Cases

01Providing context for new team members regarding past architectural tradeoffs

02Maintaining a historical log of infrastructure changes for compliance and auditing

03Documenting the selection of specific frameworks or databases for new projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agentient/vibekit architectural-decision-records

For use in Claude.ai and ChatGPT

Download Skill