メニュー
設計判断・プロセス決定をADR (Architecture Decision Record) として作成・更新する具体的な手順。Use this skill whenever the user asks to record a decision, write an ADR, or says ADRを書きたい, 設計判断を記録したい, ADR作って, この決定を残したい.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
docs/design配下の設計ドキュメントを、経緯を含めない最新スナップショットとして更新する手順。Use this skill whenever the user asks to update design docs, keep documentation current, or says 設計ドキュメントを更新, design docを直して, アーキテクチャドキュメントを最新化して.
本リポジトリの必須開発フロー(機能設計→詳細設計[ラバーダック]→テスト作成[ラバーダック]→TDD実装(Red/Green/Refactor)→テスト(+E2E)→振り返り[ラバーダック])をオーケストレーションする。Use this skill whenever the user asks to implement a new feature, start a feature, fix a bug with proper process, or says 新機能を実装, 機能を追加, 設計から始めて, feature実装, ちゃんとした手順で実装して, TDDで実装.
| name | adr-workflow |
| description | 設計判断・プロセス決定をADR (Architecture Decision Record) として作成・更新する具体的な手順。Use this skill whenever the user asks to record a decision, write an ADR, or says ADRを書きたい, 設計判断を記録したい, ADR作って, この決定を残したい. |
ADRの運用ルールの全体像は docs/adr/README.md を参照。
このskillは「今まさにADRを1本書く/更新する」ときの実務手順をまとめたもの。
以下のいずれかに該当する決定は、口頭やコミットメッセージだけで済ませず、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-fix agentに委譲してよい）。docs/design/ のドキュメントがあれば、そこから今回のADRへリンクを追加する。Status だけを Superseded by ADR-YYYY に変更する。Context に「なぜADR-XXXXを置き換えるのか」を書く。docs/adr/README.md の一覧表のStatus列も更新する。決定内容自体に自信がない場合は、ADRを書く前に task ツールで agent_type: "rubber-duck" を使い、
決定の妥当性をレビューしてから起票する（feature-workflow の
詳細設計フェーズと同じ扱い）。