musubix-adr-generation

MUSUBIX ADR Generation Skill

This skill guides you through creating Architecture Decision Records following Article VIII - Decision Records.

Overview

An ADR (Architecture Decision Record) documents significant architectural decisions with their context and consequences.

ADR Template

# ADR-[NUMBER]: [Decision Title]

## ステータス
[Proposed | Accepted | Deprecated | Superseded by ADR-XXX]

## コンテキスト
[What is the issue that we're seeing that is motivating this decision?]

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

## 選択肢

### Option 1: [Name]
**メリット:**
- [Advantage 1]
- [Advantage 2]

**デメリット:**
- [Disadvantage 1]
- [Disadvantage 2]

### Option 2: [Name]
**メリット:**
- [Advantage 1]

**デメリット:**
- [Disadvantage 1]

## 結果
[What becomes easier or more difficult to do because of this change?]

## トレーサビリティ
- 関連要件: REQ-XXX-NNN
- 関連設計: DES-XXX-NNN

Common ADR Topics

1. Technology Selection

# ADR-001: Use TypeScript for Backend

## コンテキスト
We need to choose a programming language for the backend API.

## 決定
We will use TypeScript with Node.js.

## 選択肢

### Option 1: TypeScript + Node.js
**メリット:**
- Type safety reduces runtime errors
- Same language as frontend (code sharing)
- Large ecosystem (npm)
- Strong async/await support

**デメリット:**
- Slower than compiled languages
- Type definitions not always available

### Option 2: Go
**メリット:**
- High performance
- Strong concurrency support

**デメリット:**
- Different language from frontend
- Smaller ecosystem for web

## 結果
- Frontend/backend code sharing enabled
- Need to maintain TypeScript configuration
- Team can use consistent tooling

2. Architecture Pattern

# ADR-002: Layered Architecture with DDD

## コンテキスト
We need to define the overall architecture pattern.

## 決定
We will use Layered Architecture with Domain-Driven Design principles.

## 選択肢

### Option 1: Layered Architecture
- Presentation → Application → Domain → Infrastructure

### Option 2: Hexagonal Architecture
- Ports and Adapters pattern

## 結果
- Clear separation of concerns
- Domain logic isolated from infrastructure
- Easier testing with dependency injection