adr

Create and update Architecture Decision Records in Korean in docs/decisions/.

1|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/kubrickcode/specvital --skill adr-kubrickcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/kubrickcode/specvital/tree/main/.claude/skills/adr
Command: npx skills add https://github.com/kubrickcode/specvital --skill adr-kubrickcode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you systematically record and manage architecturally significant decisions, ensuring clarity, traceability, and a shared understanding of project evolution.

Core Features & Use Cases

  • Decision Recording: Creates structured Architecture Decision Records (ADRs) following a standardized template.
  • Contextualization: Gathers context from conversation history and tagged files to inform ADR content.
  • Duplicate Prevention: Scans existing ADRs to avoid redundant records.
  • Use Case: When a significant change to the system's architecture is proposed, use this Skill to create an ADR documenting the problem, considered options, the final decision, and its rationale.

Quick Start

Use the adr skill to create a new architecture decision record for the topic 'Implement a caching layer'.

Frequently Asked Questions about adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document architectural decisions to track technical debt and project evolution?

You document architectural decisions using Architecture Decision Records (ADRs) to ensure clarity, traceability, and shared understanding of project evolution. This skill systematically records problems, considered options, final decisions, and rationales in a standardized template.

What is the best way to create an Architecture Decision Record from conversation context?

Creating an Architecture Decision Record from conversation context involves parsing user input and tagged files to inform the ADR content. This skill generates records in the docs/decisions/ directory, following specific numbering and content guidelines.

How do I manage superseded ADRs and prevent duplicate architecture decision records?

Managing superseded ADRs and preventing duplicates involves scanning existing records to avoid redundancy and updating statuses for superseded decisions. This skill supports cross-linking and status updates to maintain accurate architectural documentation.

When do I need to write an Architecture Decision Record for a software engineering project?

You need to write an Architecture Decision Record when a significant change to the system's architecture is proposed. Use this skill to create an ADR documenting the problem, considered options, the final decision, and its rationale.

Does this ADR generation skill work without external dependencies?

Yes, this Architecture Decision Record generation skill works without external dependencies. It operates independently to parse conversation context and user input, generating structured ADRs in Korean within the docs/decisions/ directory.

What are the limitations of using a standardized template for architecture decision records?

The limitation of using standardized templates for architecture decision records is that output is constrained to specific numbering and content guidelines. This skill generates ADRs in Korean, which may require translation for non-Korean speaking teams.