When should I use the ADR skill?

You should activate this skill whenever you make a decision that has a lasting impact on your project, such as selecting a new framework, designing a database schema, or choosing an authentication model.

Where are the ADR files stored?

Following industry best practices, this skill helps you store sequentially numbered markdown files in a dedicated 'docs/adr/' directory within your repository for version-controlled history.

How does this help with team collaboration?

It provides a single source of truth for the 'why' behind technical choices, making it easier for new team members to understand the architecture and preventing repetitive debates over past decisions.

An Architectural Decision Record (ADR) is a document that captures a significant technical decision, the context in which it was made, and the resulting consequences and trade-offs.

Architectural Decision Records

Name: Architectural Decision Records
Author: Agentient

byAgentient

学習とドキュメンテーション

Standardizes technical decision-making by providing structured templates and best practices for documenting architectural choices and trade-offs.

概要

This skill enables developers to capture the rationale behind significant technical decisions through standardized Architectural Decision Records (ADRs). By providing structured templates and clear guidelines, it helps engineering teams document technology selections, design patterns, and trade-offs, ensuring a searchable history of why specific paths were chosen. This is particularly useful for maintaining long-term project health, facilitating developer onboarding, and aligning team members on architectural strategy without the manual overhead of document formatting.

主な機能

Strategic triggers for infrastructure, security, and data modeling decisions
Reference examples for modern web architectures and pattern selection
Standardized ADR templates including context, decision, and consequence sections
0 GitHub stars
Automated guidance for technology selection and architectural trade-off analysis
Lifecycle management for decisions including Proposed, Accepted, and Superseded statuses

ユースケース

Establishing team-wide architectural patterns for security and performance
Documenting the rationale for choosing a specific tech stack or framework
Recording data modeling decisions and schema design trade-offs

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

GitHub

概要