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.

主な機能

Guided identification of technical trade-offs and alternative solutions
Enforcement of consistent file naming conventions and directory structures
Seamless integration with major refactoring and system design workflows
9 GitHub stars
Automated context gathering via git diff and commit history analysis
Standardized ADR templating including status, context, and consequences

ユースケース

Capturing design decisions for new API structures and data models
Recording the rationale and trade-offs of a major system architecture refactor
Documenting the selection of a specific framework or library over competitors

概要

主な機能

Guided identification of technical trade-offs and alternative solutions
Enforcement of consistent file naming conventions and directory structures
Seamless integration with major refactoring and system design workflows
9 GitHub stars
Automated context gathering via git diff and commit history analysis
Standardized ADR templating including status, context, and consequences

ユースケース

Capturing design decisions for new API structures and data models
Recording the rationale and trade-offs of a major system architecture refactor
Documenting the selection of a specific framework or library over competitors