Use to run or continue domain exploration with the product owner as domain expert — event storming interviews, hotspots (HS), ubiquitous language, UX review of the domain, checking or resolving open MQ/UX items, or a status summary of documents/ddd. Also use when the user starts explaining their business, purpose or workflow. Never edit documents/ddd directly; go through this skill.
インストールする前に、エージェントに与えられる指示の中身を確認できます。
documents/ddd/ を育てる。登場人物:
ddd-domain-explorer（フェーズ 1）= ファシリテータ。聞き取って正式ドキュメントを更新する。実装の問いは聞かない。ddd-ux-reviewer = 不在の利用者の代弁。ux-review.md に仮説を起票する。lean-domain-modeler（フェーズ 2）= 形式化役。正式ドキュメントを lean/ に翻訳し、詰まった曖昧さを model-review.md に MQ として起票する。道具: このスキルの scripts/ddd.mjs <start|questions|answers|end|status>（node <skills>/ddd/scripts/ddd.mjs。以下 ddd.mjs）。
| 引数 | 動き |
|---|---|
なし / session | フルループ |
status | ddd.mjs status の出力を示すだけ |
review | UX レビューだけ |
clean | 後片付けだけ（手順 5） |
| それ以外 | テーマ指定でフルループ（例: ddd スキルに MQ-003 を検証したい を渡す） |
ddd.mjs start（5 ファイルの存在確認と .session 印。印がある間だけ hook が documents/ddd/ の編集を許す。event-timeline.md 冒頭のプロダクトの一言を出力し、置き場のままなら止まる — start --domain "<一言>" で書く。用語集に無いモデルの名前があれば documents/ddd/naming.md に書き、件数を出す）。ddd-domain-explorer を起動する。プロンプトに書くのは「探索セッションを 1 回実施する」「その時点で聞けるものは 1 巡に全部載せる」「読むのは documents/ddd/ だけ（lean/ は読まない）」「テーマ: …（指定があれば）」だけ。現状の要約は渡さない（自分で読む）。
run_in_background: false）。返事は SendMessage。spawn_agent（agent_type: "ddd-domain-explorer"）。wait_agent を最終状態になるまで繰り返す。タイムアウト（空の status）は待ち直すだけで、send_input で「完了して報告を返せ」と急かさない（急かすと問いが捨てられる）。返事は send_input。[SESSION_REPORT] が返るまで繰り返す）:
[QUESTIONS] + JSON を返す → 問いが少なければ（その時点で聞けるものが他にあるなら）差し戻す。ddd.mjs questions @<json を保存したファイル> で documents/ddd/questions.md を書く（改変せず写す。書式は references/question-format.md）。Runtime/Scenarios.lean に一時シナリオ（probe-q1-a 命名）、規則が変わるものは一時の枝。JS でこしらえない。用意できない選択肢は表に「—」と理由。
ddd.mjs start が「骨格のサンプル」と言う間はプローブを用意しない（questions.md にモックアップ欄が出ない）。サンプルのメモは実ドメインではなく、中継役も探索の根拠に lean/ を使わない。cd lean && lake build が通ることを確かめる（通らないプローブは出さない）。ddd.mjs answers の出力（「質問 → 回答」の列、空欄は「未回答」）を 一字一句そのまま explorer に返す。回答の代わりの指示（中断・テーマ変更）もそのまま伝える。[QUESTIONS] も [SESSION_REPORT] も付けずに終わったら、推測で問いかけファイルを組み立てず explorer に確認する。[SESSION_REPORT] をユーザーに日本語で簡潔に伝える（テーマ・更新内容・新規 / 解決した HS・検証した UX / MQ）。scenarioByName の登録・一時の枝・モックアップの「問いを試す」）を消し、ddd.mjs end を実行する
（questions.md・naming.md を消し、cradle ddd-clean-check --build で残骸が無いことと lean/ が ddd.mjs start の時点と同じことを機械で確かめ、通れば .session を消す）。
残っていれば編集を手で戻して ddd.mjs end をやり直す — モデルを変えるのはフェーズ 2 の仕事。基準は HEAD ではなく start の時点なので、git checkout / git stash で戻さない（未コミットの形式化まで消える）。検査が通るまで .session が残り、その間 hook は documents/ddd/ の編集を許したまま（片付けは中継役だけが行う）。前の探索が終わらないまま lean/ を形式化したなら .session を消してから start する。
end は ddd.mjs answers を中継した後でだけ通る。回答を待たずに問いを捨てて終えるのは --abandon（ユーザーがそう決めたときだけ）。片付けは中継役の仕事で、explorer にやらせない。ddd-ux-reviewer をバックグラウンドで起動し、完了したら起票（ID・種別・要約）を中継する。cradle refs <ID> で派生（Lean の出典・openapi・infra-design・README）を洗い、失効した記述を直す（cradle unslop --all の lean-ref-retracted も見る）。撤回の記法は documents 規約。documents/ddd/ が無いときは cradle-init スキルを案内する。まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Use when adding or changing REST endpoints or the OpenAPI contract — deriving endpoints from the Lean commands and views, writing documents/codebase/openapi.yaml first, then regenerating the backend controller interfaces and the frontend client.
日本語の概要は準備中です。原文の説明を表示しています。
Use after a backend build succeeds or whenever authentication, authorization, actor/identity handling, external service calls (IdP, JWKS, DB, clock), logging, observability, configuration or error contracts are in play — delegates to the backend-design-reviewer agent for a design-quality review of the current branch.
日本語の概要は準備中です。原文の説明を表示しています。
Use when it is time to make the backend follow the Lean model — regenerate Kotlin from Lean, implement the generated interfaces (UseCase, QueryService, Repository, Entity), wire every generated contract test, make the build green, then run the design and SQL reviews. Backend comes after the human confirmed the screens.
日本語の概要は準備中です。原文の説明を表示しています。
Use when you need the current position in the Lean spec-driven pipeline, or any deterministic check of a Cradle project — status, golden regression, Lean layer walls, regeneration impact, unslop lint, ddd cleanup. Runs the scripts under scripts/ and reports their output verbatim.
日本語の概要は準備中です。原文の説明を表示しています。
Use to start a new product on Cradle or to add the Cradle skeleton to an existing repository — writes cradle.json, the project-facts instruction (.apm/instructions/project.instructions.md), documents/{ddd,ai-notes,infra-design,codebase} templates, CI, and a compiling Lean executable-spec scaffold with a minimal example domain, mockup and CLI.
日本語の概要は準備中です。原文の説明を表示しています。
Use when the product owner asks where the project stands, what to do next, or which phase of the Lean spec-driven pipeline is current — runs cradle status and proposes exactly one next step.
日本語の概要は準備中です。原文の説明を表示しています。