What template does this skill use?

It uses a comprehensive template including sections for Context, Decision, Consequences (positives/negatives), Linkbacks to specs, and a Behavior Delta.

How does the skill handle file numbering?

The skill scans the docs/ADRs directory for existing files, sorts them numerically, and automatically increments the number for your new record (e.g., 0001, 0002).

When should I use the ADR skill?

Use it whenever you are making significant changes to system behavior, API contracts, tenancy/RLS, or any integration that impacts the project's long-term architecture.

An Architecture Decision Record (ADR) is a document that captures a significant architectural decision made along with its context and consequences, serving as a historical log for the project.

Where does this skill store the ADR files?

The skill automatically generates and stores markdown files within the docs/ADRs/ directory of your project.

Architecture Decision Records

Name: Architecture Decision Records
Author: mcart13

bymcart13

0•

Learning & Documentation

Standardizes the creation and management of Architecture Decision Records (ADRs) within the TCC framework.

The ADR skill enables developers to document significant architectural choices, system behaviors, and infrastructure changes systematically. It automates the process of identifying the next sequential record number and provides a structured markdown template that captures vital context, decisions, consequences, and behavior deltas. This ensures that every major shift in system contracts, security posture, or data retention is recorded for long-term maintainability and team alignment.