architecture-decision-records

Detect architectural decision phrases and generate structured ADR documents.

2|Updated Apr 14, 2026

Search Tags:#standardization #decision tracking #code documentation #architectural decisions #ADRs

Ready to run

npx skills add https://github.com/klu-dev/porting-ecc-to-vscode --skill architecture-decision-records-klu-dev

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/klu-dev/porting-ecc-to-vscode/tree/main/.github/skills/architecture-decision-records
Command: npx skills add https://github.com/klu-dev/porting-ecc-to-vscode --skill architecture-decision-records-klu-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of recording architectural decisions made during code sessions, ensuring they are captured and easily accessible for future reference.

Core Features & Use Cases

Automated Decision Detection: Identifies key decision-making moments in coding sessions.
Structured Documentation: Generates ADRs in a standardized format for easy comprehension.
Version Control Integration: Stores ADRs within the repository for version tracking and collaboration.
Use Case: After implementing a new database schema, record the decision with reasons, alternatives considered, and consequences in a single, structured document.

Quick Start

Record a new architectural decision: "Let's start a new ADR for the database migration."

Frequently Asked Questions about architecture-decision-records

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

FAQPage Schema

How do I automate capturing architectural decisions made during coding sessions?▼

You can automate capturing architectural decisions by monitoring conversation threads for key decision phrases, which triggers the automated formatting of structured ADR documents for future reference.

What is the best way to track architectural decisions and their alternatives in code documentation?▼

Tracking architectural decisions is best handled by generating standardized ADR documents that record the decision, reasons, alternatives considered, and consequences in a single, structured format.

How do I generate a standardized ADR document after implementing a new database schema?▼

You generate a standardized ADR document by triggering the capture process during your coding session, which formats the architectural choice, alternatives, and consequences into a structured file.

Can I store architectural decision records in my repository for version tracking?▼

Yes, you can store architectural decision records within your repository, enabling version control integration to track documentation changes and support collaborative coding workflows.

Does automated decision detection work in collaborative coding environments?▼

Automated decision detection works in collaborative coding environments by monitoring conversation threads for architectural decision phrases, ensuring critical decisions are documented for the team.