skills.rest
xxih
xxihCOMMUNITY
Explore all skills by this author →
GitHub

architecture-decision-records

Capture architecture decisions as structured ADR documents in docs/adr.

1|Updated Mar 18, 2026
Search Tags:#git#architecture#documentation#adr#decision#project
One-click install
npx skills add https://github.com/xxih/ai-harness-zh --skill architecture-decision-records-xxih
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/xxih/ai-harness-zh/tree/main/references/translations/everything-claude-code/docs/zh-CN/skills/architecture-decision-records
Command: npx skills add https://github.com/xxih/ai-harness-zh --skill architecture-decision-records-xxih

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams often lose critical architecture decisions to informal discussions, making future maintenance difficult and leading to knowledge gaps.

Core Features & Use Cases

  • Detect decision moments during coding sessions and prompt the user to create an ADR.
  • Generate a structured ADR file, assign a sequential number, and update the ADR index in docs/adr/README.md.
  • Retrieve and display existing ADRs when users ask about past decisions.

Quick Start

Ask the assistant to record an architecture decision by saying, “Create an ADR for our choice to use Next.js over Vue.”

Frequently Asked Questions about architecture-decision-records

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

FAQPage Schema
How do I capture architecture decisions as ADR documents during coding sessions?▼

To capture architecture decisions as ADR documents during coding, you can prompt the assistant to record a decision. It detects decision moments, gathers context, and generates a structured ADR file in your project's docs/adr directory.

What is the best way to maintain an ADR index automatically when adding new architecture decisions?▼

The best way to maintain an ADR index automatically is to use a tool that assigns a sequential number to each new architecture decision and updates the docs/adr/README.md file with the new entry upon creation.

Can I retrieve existing architecture decision records when asking about past project decisions?▼

Yes, you can retrieve existing architecture decision records by asking the assistant about past decisions. It retrieves and displays the relevant ADR files from your project repository on request.

How do I prevent losing critical architecture decisions to informal discussions?▼

To prevent losing critical architecture decisions to informal discussions, capture them as structured ADR files. This ensures future maintenance is easier and bridges knowledge gaps by documenting decisions directly within the project.

What is an ADR file and where should it be stored in a git project?▼

An ADR file is a structured document recording an architecture decision. It should be stored in the docs/adr directory of your git project, with a sequential number assigned and an index updated in docs/adr/README.md.

Related Skills

Explore More Software Engineering Skills→
kmylpenterkmylpenter

np

Initialize a new project directory with a standardized KFG structure and Git setup.

Community
Intermediate
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate
techwithanirudhtechwithanirudh
167

create-changeset

Analyze git commit history and generate changeset markdown files.

Community
Intermediate
ps-carvalhops-carvalho

docs-writer

Generate decision logs, feature documents, and flow documents from code changes and project plans.

Community
Intermediate