القائمة
設計判断・プロセス決定を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 の
詳細設計フェーズと同じ扱い）。