PJR-0129 Why-What-How作成原則をrecipeへ反映
1. 概要
Why・What・How・Traceを章順ではなく論理の骨格として定義し、各成果物recipeへ重複なく適用する
agent が手段や網羅的な説明へ引っ張られず、主要な論点を保って成果物を作成できるよう、Why・What・How・Trace を共通の論理構造として定義する。全成果物へ同じ章順を強制せず、共通原則は一か所に置き、各 recipe には成果物の責務に応じた問いと適用方法だけを反映する。
2. 完了条件
- Why・What・How・Trace の意味、相互関係、記述時の判定基準が共通原則として定義されている。
- 共通原則が「章の固定順」ではなく「主要な主張・判断の論理の骨格」であることが明記されている。
- Markdown、表形式の登録簿、YAML など、成果物形式に応じた適用方法または非適用条件が定義されている。
- 対象 recipe には共通説明を複製せず、その成果物で答えるべき固有の問いと委譲境界が記載されている。
- sample または代表成果物を用いて、Why から What / How への対応を追えることが確認されている。
- recipe の指示によって成果物の責務外の詳細や重複記述を要求しない。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | Why・What・How・Trace の共通原則とアンチパターンを定義する | ARC | done | 論理の骨格として一か所に定義 |
| 2 | recipe を成果物種別ごとに棚卸しし、適用対象と適用方法を決める | ARC | done | Markdown・登録簿・YAML・実行結果を定義 |
| 3 | 対象 recipe の問い・深掘り手順・仕上げ確認へ固有部分を反映する | ARC | done | 全 16 recipe に固有の対応と委譲境界を反映 |
| 4 | 代表 sample / 成果物で論点、簡潔性、委譲境界への効果を確認する | BA | done | 概要 sample と SpecDojo 概要で対応を確認 |
4. 対応結果
- Recipe 記述標準に、Why・What・How・Trace の意味、相互関係、判定基準、形式別の適用方法、非適用条件、アンチパターンを定義した。4 要素は固定章ではなく、主要な主張・判断の論理の骨格として既存の章・表・フィールドへ配置する。
docs/ja/specdojo/recipes/配下の全 16 recipe を棚卸しし、各「このレシピの使い方」に成果物固有の Why / What / How / Trace と責務外の委譲先を記載した。共通原則の説明は各 recipe へ複製していない。- 各 recipe の「仕上げチェック」に、成果物固有の論点・判断・方法・証跡の対応を確認する項目を追加した。YAML recipe は schema 外キーを増やさず
based_onと既存 ID、登録簿 recipe は行 ID・根拠・対応・証跡、実行 result はdone_criteriaと同じ result で追跡する。 - プロジェクト概要サンプルと SpecDojo プロジェクト概要を代表例として確認した。背景・必要性と中心仮説（Why）から、実現したいこと・価値仮説（What）、基本的な考え方・判断原則（How）、
CH-01/BV-01〜BV-04と後続文書参照（Trace）を追え、詳細スコープ・受入条件・設計が委譲されていることを確認した。
5. 関連ドキュメント
- launch trackの振り返り — 起票元
- prj-overviewのプロジェクトWhyを明確化 — project-level Why の整備
- specdojo:needs-to-implementation-philosophy — Why / What / How の既存概念
- specdojo:kata-guide — recipe の役割と参照方針