create-architectural-decision-record

アーキテクチャ決定記録の作成

AI による利用と人間による可読性に最適化された構造化フォーマットを使用して、${input:DecisionTitle} の ADR ドキュメントを作成します。

入力

• コンテキスト: ${input:Context}
• 決定: ${input:Decision}
• 代替案: ${input:Alternatives}
• ステークホルダー: ${input:Stakeholders}

入力の検証

必須入力が提供されていない場合、または会話履歴から判断できない場合は、ADR の生成を進める前に、不足している情報を提供するようユーザーに依頼してください。

要件

• 正確で曖昧さのない言葉を使用する
• フロントマターを含む標準化された ADR フォーマットに従う
• 肯定的な結果と否定的な結果の両方を含める
• 却下の根拠とともに代替案を記載する
• 機械による解析と人間による参照の両方に適した構造にする
• 複数項目のセクションにはコード化された箇条書き（3〜4 文字のコード + 3 桁の数字）を使用する

ADR は /docs/adr/ ディレクトリに、adr-NNNN-[title-slug].md という命名規則で保存する必要があります。ここで NNNN は次の連番の 4 桁の番号です（例: adr-0001-database-selection.md）。

必要なドキュメント構造

ドキュメントファイルは以下のテンプレートに従い、すべてのセクションが適切に記入されていることを確認してください。Markdown のフロントマターは、以下に示す例に従って正しく構造化する必要があります。

---
title: "ADR-NNNN: [Decision Title]"
status: "Proposed"
date: "YYYY-MM-DD"
authors: "[Stakeholder Names/Roles]"
tags: ["architecture", "decision"]
supersedes: ""
superseded_by: ""
---

# ADR-NNNN: [Decision Title]

## Status

**Proposed** | Accepted | Rejected | Superseded | Deprecated

## Context

[Problem statement, technical constraints, business requirements, and environmental factors requiring this decision.]

## Decision

[Chosen solution with clear rationale for selection.]

## Consequences

### Positive

- **POS-001**: [Beneficial outcomes and advantages]
- **POS-002**: [Performance, maintainability, scalability improvements]
- **POS-003**: [Alignment with architectural principles]

### Negative

- **NEG-001**: [Trade-offs, limitations, drawbacks]
- **NEG-002**: [Technical debt or complexity introduced]
- **NEG-003**: [Risks and future challenges]

## Alternatives Considered

### [Alternative 1 Name]

- **ALT-001**: **Description**: [Brief technical description]
- **ALT-002**: **Rejection Reason**: [Why this option was not selected]

### [Alternative 2 Name]

- **ALT-003**: **Description**: [Brief technical description]
- **ALT-004**: **Rejection Reason**: [Why this option was not selected]

## Implementation Notes

- **IMP-001**: [Key implementation considerations]
- **IMP-002**: [Migration or rollout strategy if applicable]
- **IMP-003**: [Monitoring and success criteria]

## References

- **REF-001**: [Related ADRs]
- **REF-002**: [External documentation]
- **REF-003**: [Standards or frameworks referenced]