skills.rest
Aytsuu
AytsuuCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

architecture-decision-records

Capture and manage architectural decisions in a structured ADR format.

Updated May 28, 2026
Search Tags:#decision logging#ADR#codebase management#architectural decisions#architecture decision records
One-click install
npx skills add https://github.com/Aytsuu/codemini --skill architecture-decision-records-aytsuu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision-records
Source: https://github.com/Aytsuu/codemini/tree/main/.agents/skills/architecture-decision-records
Command: npx skills add https://github.com/Aytsuu/codemini --skill architecture-decision-records-aytsuu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines the capture and management of architectural decisions during coding sessions, ensuring they are recorded and easily accessible for future reference.

Core Features & Use Cases

  • Decision Capture: Automatically detect decision moments and prompt users to record structured ADRs.
  • Contextual Information: Gather context, alternatives considered, and rationale for each decision.
  • ADR Log: Maintain an ADR log that documents the evolution of the codebase and its architectural choices.
  • Workflow Automation: Automate the process of capturing new ADRs, reading existing ones, and updating the ADR index.
  • Integration: Works with other agents like Planner and Code Reviewer to suggest and flag architectural changes.

Quick Start

Start capturing ADRs by saying "let's record this decision" or "ADR this."

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 architecture decision record capture during coding sessions?▼

You can automate architecture decision record capture by using scripts that monitor conversations for decision signals, prompt you to log structured ADRs, and maintain a centralized ADR log for codebase management.

What is the best way to document architectural decisions and alternatives considered?▼

Documenting architectural decisions is best handled by capturing contextual information, alternatives considered, and rationale in a structured ADR format to ensure codebase management choices are easily accessible for future reference.

Do I need Python to manage an ADR log for codebase management?▼

Yes, you need Python installed to run the scripts required for automating ADR capture and managing the YAML configuration that maintains your architectural decisions log.

Can I integrate architecture decision records with a code review workflow?▼

Architecture decision records can integrate with code review workflows by flagging architectural changes and working alongside planner agents to maintain and update the ADR index automatically.

How do I start logging a new architectural decision?▼

You can start logging a new architectural decision by simply saying "let's record this decision" or "ADR this" to trigger the automated capture of context, alternatives, and rationale.

When should I maintain an ADR index for architectural decisions?▼

You should maintain an ADR index whenever architectural choices evolve during coding sessions, ensuring the structured ADR log accurately documents the codebase history for future reference.

Related Skills

Explore More Software Engineering Skills→
eaglhuangeaglhuang
3

ui-runtime-verify

Refresh Cocos asset-db, run UI validation scripts, and produce runtime-verdict artifacts.

Community
Intermediate
legioncodeinclegioncodeinc
72

adr-writing-stinger

Create Architecture Decision Records with context, alternatives, and consequences.

Official
Advanced
PaloAltoNetworksPaloAltoNetworks
3

adr-check

Check codebase changes for ADR conformance and identify required updates.

Official
Intermediate
hgflimahgflima
1

documentation-and-adrs

Create and manage architectural decision records using markdown templates.

Community
Advanced