← ClaudeAtlas

create-adrlisted

Create a new Architecture Decision Record (ADR) as a single self-contained HTML file using the tech-docs design system. Use when the user asks to write/draft/create an ADR, document an architectural decision, record a design trade-off, or capture rationale for a technical choice (e.g. "ADR を書いて", "この決定を記録したい", "design decision を残したい").
9uiLe/plugins · ★ 0 · Data & Documents · score 72
Install: claude install-skill 9uiLe/plugins
# create-adr — Architecture Decision Record を書く このスキルは **MADR 形式の ADR を 1 枚の HTML として生成** します。 完成物はブラウザでそのまま開ける自己完結ファイル + 共有アセットの組み合わせです。 --- ## 1. 進め方 (必ずこの順番で) 1. **対象ディレクトリの確認** - ユーザーが出力先を明示していなければ、現在の作業ディレクトリ直下に `docs/adr/` を提案し、合意を取る。 - 既存の ADR ディレクトリがあれば、その採番ルール (例: `0001-xxx.html`) に従う。 2. **必要情報を 1 メッセージにまとめて確認** ユーザーが既に情報を提供している場合は二重に聞かない。不足している場合のみ、次の項目をまとめて 1 度だけ質問する: - タイトル (短く、決定の本質を表す名詞句) - ADR 番号 (既存ディレクトリの最大+1 を提案) - Status (`Proposed` / `Accepted` / `Deprecated` / `Superseded` / `Rejected`) - 決定者 (Deciders) と日付 - 背景 (Context) — なぜこの決定が必要になったか - 検討した選択肢 (最低 2 つ) と各案のメリット/デメリット - 採用した案とその理由 - 想��される帰結 (Positive / Negative / Neutral) - 関連リンク / 参考資料 (任意) 3. **生成** - `${PLUGIN_ROOT}/shared-assets/templates/skeleton-adr.html` を雛形にする。 - 出力先 (例: `docs/adr/0007-event-bus-vs-direct-rpc.html`) に書き出す。 - 同じディレクトリの **`system/` サブディレクトリに共有アセットをコピー** する (詳細は §3)。 4. **報告** - 生成したファイルパス、コピーしたアセット、未確定の項目 (Open Questions) を 1 段落で報告する。 - ブラウザで開いて確認するよう促す (`open <path>` または `python3 -m http.server` を案内)。 --- ## 2. 章立て (MADR — 雛形から不要な節は削除可) ``` h1: ADR-NNNN · タイトル → adr-frontmatter (ADR / Status / Date / Deciders / Tags) h2: Context … 背景と問題 h2: Decision Drivers … 判断基準 (箇条書き) h2: Considered Options … 各案の説明 + 比較表 h2: Decision … 結論 (callout--success で強調) h2: Consequences … Positive / Negative / Neutral h2: Compliance & Monitoring … 任意 (遵守を担保する仕組み) h2: References ``` - **Decision は