## 17. ドキュメント・設計

確認：2026年9月

| 役割 | 既定 | 代替と乗り換え条件 |
|---|---|---|
| 設計判断の記録 | **ADR（`docs/adr/0001-xxx.md`）** | — |
| 図 | **Mermaid**（GitHubでそのまま描画される） | D2：レイアウトを細かく制御したいとき。draw.io：非エンジニアと共同編集するとき |
| ER図 | **tbls**（実DBから自動生成） | — |
| APIドキュメント | **OpenAPI＋Scalar** | — |
| 開発者向けドキュメントサイト | **Astro Starlight** | — |
| READMEに必ず書くこと | セットアップ手順、主要コマンド、環境変数一覧、デプロイ方法、連絡先 | — |