Where are the ADR files stored?

ADRs are typically created in the docs/adr/ directory with a sequential numbering and descriptive slug format, such as 0001-use-redis-caching.md.

When should I trigger the ADR Creator skill?

You should use it when making significant choices like selecting a database, choosing a state management library, or designing a new system component.

Does this skill help with team collaboration?

Yes, by documenting the 'why' behind code changes, it helps team members understand past decisions during code reviews and onboarding.

What is an Architecture Decision Record (ADR)?

An ADR is a short text file that captures a significant architectural decision, the context in which it was made, and the consequences it has for the project's future.

How does the ADR Creator skill gather information?

The skill analyzes your current implementation by reviewing git diffs, logs, and modified files to understand the technical changes and the problem they solve.

ADR Creator

Name: ADR Creator
Author: majesticlabs-dev

bymajesticlabs-dev

•

学习与文档

Generates standardized Architecture Decision Records (ADRs) to document technical choices and preserve institutional knowledge.

The ADR Creator skill automates the process of documenting critical architectural decisions directly within your repository. By analyzing your implementation details and git history, it helps capture the 'why' behind technical choices, including the context, alternatives considered, and long-term consequences. This skill ensures that your team maintains a clear, searchable history of design trade-offs, preventing technical debt and providing invaluable context for future developers during refactoring or system migrations.

主要功能

01Guided identification of technical trade-offs and alternative solutions

02Enforcement of consistent file naming conventions and directory structures

03Seamless integration with major refactoring and system design workflows

049 GitHub stars

05Automated context gathering via git diff and commit history analysis

06Standardized ADR templating including status, context, and consequences

使用场景

01Capturing design decisions for new API structures and data models

02Recording the rationale and trade-offs of a major system architecture refactor

03Documenting the selection of a specific framework or library over competitors

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add majesticlabs-dev/majestic-marketplace create-adr

For use in Claude.ai and ChatGPT

Download Skill