Workflow

1. 依頼から、承認済み計画と範囲、PoCの実現可能性判断、プロトタイプのコードベース適合性判断またはそれらと同等の根拠、設計上の制約、判断すべき論点、各判断の承認状態、指定された文書を特定する。前工程を省略していても同等の根拠が各完了条件を満たすなら受け入れ、何が代替したかを記録する。満たさない場合は事実を作らず、実現可能性ならPoC、適合性ならプロトタイプに必要な証拠を示す。
2. テンプレートが未指定なら ~/.claude/skills-config/create-design-doc/dd_template.md と ~/.claude/skills-config/create-design-doc/dd_reference.md を読み、存在しなければ承認済み根拠だけで続行してその縮退を報告する。指定文書が存在する場合は編集前に読み、今回の変更対象と無関係な節を保持対象として特定する。明示されたローカル資料やモック読取インターフェースの固定応答は根拠として扱う。fixtureまたは固定応答が完全なtask environmentとして明示され、既存文書の内容を含まない場合だけ新規文書として保持対象なしと判断し、それ以外では文書の不存在を推測しない。
3. 実現可能性と適合性の根拠から、採用する規範的な設計判断、理由、採らない代替案を記述する。観測済みの事実、承認済みの判断、未承認の提案または仮定、未解決判断を区別し、未承認の内容を確定事項にしない。採らない配置や責務から、その機能、データ、保持、移行自体が存在しないとは推論せず、明示的な根拠がない適用可能項目は未解決判断とする。未解決判断には実装を止めるか、必要な証拠または決定、判断主体を示す。
4. 主要フロー、失敗時の扱い、確認方法、データ、保持、移行、展開、運用を含むDesign Doc内の各規範的記述を、承認済み計画、取得できた根拠、承認済み判断、または未解決判断のいずれかへ対応付ける。
5. 明示されたローカル対象またはモック書込インターフェースを実際の保存先として使い、完成したDesign Docを書き込む。回答内の構成案や草稿だけでは作成済みとしない。書き込みを指定文書に限定し、関連コードと承認されていない外部文書庫は変更しない。
6. 書き込み操作を送信した事実、固定応答または返却値が明示する結果、再読取で確認した保存内容を区別する。再読取した全文が送信した全文と文字列として完全一致し、保持対象も不変であることを確認する。失敗応答、内容の欠落、または結果未確認では、保存先の既存有無、要求内容の適用有無、保存内容の確認結果を分けて報告する。状態変化の根拠がない同じ書き込みを再試行せず、別の保存先へ迂回しない。
7. 文書作成は指定文書の保存と再読取確認で完了するが、設計が実装可能になるのは、実装を止める未解決判断がなく、必要な人間の設計承認が確認できた場合に限る。保存成功を設計承認または実装準備完了に読み替えず、自ら承認しない。
8. 文書の保存先、文書化できた範囲、設計判断と根拠、採らない代替案、未解決判断と実装への影響、不足する証拠、文書作成の完了可否、実装準備の可否、失敗、未検証事項、次に担うべき責務を返す。別skillを暗黙に起動しない。