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

0•

学习与文档

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.

主要功能

01Strategic triggers for infrastructure, security, and data modeling decisions

02Reference examples for modern web architectures and pattern selection

03Standardized ADR templates including context, decision, and consequence sections

040 GitHub stars

05Automated guidance for technology selection and architectural trade-off analysis

06Lifecycle management for decisions including Proposed, Accepted, and Superseded statuses

使用场景

01Establishing team-wide architectural patterns for security and performance

02Documenting the rationale for choosing a specific tech stack or framework

03Recording 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

主要功能

01Strategic triggers for infrastructure, security, and data modeling decisions

02Reference examples for modern web architectures and pattern selection

03Standardized ADR templates including context, decision, and consequence sections

040 GitHub stars

05Automated guidance for technology selection and architectural trade-off analysis

06Lifecycle management for decisions including Proposed, Accepted, and Superseded statuses

使用场景

01Establishing team-wide architectural patterns for security and performance

02Documenting the rationale for choosing a specific tech stack or framework

03Recording 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