adr-creation

name	adr-creation
description	Generate Architecture Decision Records following the project template and numbering convention. Use when documenting architecture decisions, technical choices, or when the user asks to create an ADR.
event	architecture-decision
auto_trigger	false
version	2.0.0
last_updated	2026-01-26
inputs	["decision_title","context","options","decision","rationale"]
output	adr_document
output_format	Markdown ADR (02-ADR-TEMPLATE.md)
output_path	docs/technical/architecture/adr/
auto_invoke	{"events":["architecture-decision","design-review"],"conditions":["major technical decision made","user requests ADR"]}
validation_rules	["ADR number must be sequential","status must be valid (proposed, accepted, rejected, deprecated, superseded)","at least 2 options considered"]
chain_after	[]
chain_before	["doc-index-update"]
called_by	["@Architect","@Scribe"]
mcp_tools	["mcp_payment-syste_search_full_text","read_file","list_dir"]

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]"
   


   
   


   
   
   [, ]