AD
adr-workflow
設計判断・プロセス決定をADR (Architecture Decision Record) として作成・更新する具体的な手順。Use this skill whenever the user asks to record a decision, write an ADR, or says ADRを書きたい, 設計判断を記録したい, ADR作って, この決定を残したい.
Install
mkdir -p .claude/skills/adr-workflow && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15976" && unzip -o skill.zip -d .claude/skills/adr-workflow && rm skill.zipInstalls to .claude/skills/adr-workflow
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
設計判断・プロセス決定をADR (Architecture Decision Record) として作成・更新する具体的な手順。Use this skill whenever the user asks to record a decision, write an ADR, or says ADRを書きたい, 設計判断を記録したい, ADR作って, この決定を残したい.186 charsno explicit “when” trigger
About this skill
ADR Workflow
ADRの運用ルールの全体像は docs/adr/README.md を参照。
このskillは「今まさにADRを1本書く/更新する」ときの実務手順をまとめたもの。
いつADRを書くべきか
以下のいずれかに該当する決定は、口頭やコミットメッセージだけで済ませず、ADRとして残す。
- アーキテクチャ・プロジェクト構成に関わる決定（例: 層構成、依存方向、主要ライブラリ選定）
- 開発プロセス・ツールに関わる決定（例: テストフレームワーク、モデルルーティング方針）
- 一度決めたら覆すコストが高い決定（データ永続化方式、外部連携方式など）
逆に、些細な実装詳細（変数名、内部のprivateメソッド分割など）はADR化しない。
手順
.github/agents/adr-writer.agent.mdを使うか、以下を手動で行う。docs/adr/の既存ファイル名から次の連番を決める（歯抜けにしない）。docs/adr/template.mdをコピーして新規ファイルを作成。Context/Decision/Consequencesを埋める（docs/adr/README.mdの 不変性ルールを厳守: 一度書いたら本文は書き換えない）。docs/adr/README.mdの一覧表に1行追加する （内容判断が完了した後の目次反映のみであれば、 ADR-0008によりquick-fixagentに委譲してよい）。- 関連する
docs/design/のドキュメントがあれば、そこから今回のADRへリンクを追加する。
既存の決定を覆す場合
- 古いADRの本文は変更しない。
StatusだけをSuperseded by ADR-YYYYに変更する。 - 新しいADRの
Contextに「なぜADR-XXXXを置き換えるのか」を書く。 docs/adr/README.mdの一覧表のStatus列も更新する。
rubber-duckとの関係
決定内容自体に自信がない場合は、ADRを書く前に task ツールで agent_type: "rubber-duck" を使い、
決定の妥当性をレビューしてから起票する（feature-workflow の
詳細設計フェーズと同じ扱い）。