ADR Creation Skill

Purpose: Generate Architecture Decision Records (ADRs) following the project template and numbering convention.

Trigger

When: User requests architecture documentation OR major technical decision made Context Needed: Decision context, options considered, final decision MCP Tools:

mcp_payment-syste_search_full_text

,

read_file

ADR Numbering

Format:

NNN-SHORT-TITLE.md

001-AUTH-STRATEGY.md
002-OFFLINE-STRATEGY.md
003-[NEXT-DECISION].md

Required Sections

# ADR-NNN: [Title]

## Status

[proposed | accepted | rejected | deprecated | superseded]

## Context

[What is the issue that we're seeing that motivates this decision?]

## Decision

[What is the change that we're proposing and/or doing?]

## Options Considered

### Option 1: [Name]

**Pros:** ...
**Cons:** ...

### Option 2: [Name]

**Pros:** ...
**Cons:** ...

## Rationale

[Why was this option chosen?]

## Consequences

[What becomes easier or more difficult?]

## Related ADRs

[Links to related decisions]

Frontmatter Template

---
document_type: "adr"
module: "architecture"
status: "accepted"
version: "1.0.0"
last_updated: "YYYY-MM-DD"
author: "@username"

keywords:
  - "adr"
  - "[topic]"
  - "[technology]"

related_docs:
  database_schema: ""
  api_design: ""

adr_metadata:
  adr_number: NNN
  decision_date: "YYYY-MM-DD"
  stakeholders: ["@Architect", "@Backend"]
---

ADR Categories

Category	Keywords	Example
Architecture	pattern, structure	Monolith vs Microservices
Technology	framework, library	Angular vs React
Data	database, storage	PostgreSQL vs MongoDB
Security	auth, encryption	JWT vs Sessions
Integration	api, protocol	REST vs GraphQL

Workflow

1. Get next number - Check existing ADRs in

   docs/technical/architecture/adr/

2. Load template - Read 02-ADR-TEMPLATE.md
3. Gather context - Document the problem
4. List options - At least 2 alternatives
5. Document decision - Clear statement
6. Explain rationale - Why this choice?
7. Create file -

   docs/technical/architecture/adr/NNN-TITLE.md

Reference

• 02-ADR-TEMPLATE.md
• 001-AUTH-STRATEGY.md
• 002-OFFLINE-STRATEGY.md