planning-validate

planning-validate

/speckit.plan の完了後に、計画関連の成果物の品質と整合性を検証します。

目的

このスキルは計画関連の成果物を自動で検証し、タスク生成前に仕様の不足を検出します。次の項目を確認します。

• spec.md の完全性：必須セクションがすべて内容を含んでいる
• plan.md の実行可能性：技術コンテキスト、プロジェクト構成、憲章の確認が完了している
• data-model.md の整合性：エンティティが仕様の要件と一致している（存在する場合）
• 契約の網羅性：必要なエンドポイントの API 契約が定義されている（contracts/ が存在する場合）
• 憲章への準拠：計画がプロジェクト憲章の規則に従っている（constitution.md が存在する場合）

出力

このスキルは次の内容を含む品質評価を出力します。

• GREEN：すべてのチェックに合格 — /speckit.tasks に進んでください
• YELLOW：軽微な警告 — 確認が必要ですが、続行できます
• RED：ブロッカーを検出 — 続行する前に解決する必要があります

使用方法

このスキルは /speckit.plan の実行後に自動で実行されます。手動で実行することもできます。

npx skills run planning-validate

終了コード

コード	ステータス	意味
0	GREEN	すべてのチェックに合格
1	YELLOW	警告あり
2	RED	ブロッカーあり
3	エラー	必須ファイルが見つからない

実行されるチェック

spec.md のチェック

1. ファイルが存在し、読み取り可能である
2. Summary セクションが内容を含んでいる
3. User Stories セクションがあり、少なくとも 1 つのストーリーが含まれている
4. Functional Requirements セクションがあり、FR-XXX 項目が含まれている
5. Success Criteria セクションが存在する

plan.md のチェック

1. ファイルが存在し、読み取り可能である
2. Technical Context セクションが存在する
3. Project Structure セクションが存在する
4. Constitution Check セクションが存在する（スキップされていない場合）
5. Gate Result に PASS ステータスが示されている

data-model.md のチェック（存在する場合）

1. Entities セクションが存在する
2. 少なくとも 1 つのエンティティが定義されている
3. エンティティ名が spec.md の用語と一致している

contracts/ のチェック（存在する場合）

1. 少なくとも 1 つの契約ファイルが存在する
2. 契約ファイルが有効な Markdown である
3. 契約のエンドポイントが spec.md の要件と一致している

constitution.md のチェック（存在する場合）

1. plan.md が憲章の原則を参照している
2. Gate Result に憲章違反がない

ブロッカーの例

• 「spec.md：User Stories セクションがありません」
• 「plan.md：Constitution Check セクションのステータスが FAIL です」
• 「data-model.md：エンティティ 'UserAccount' が spec.md で参照されていません」

推奨事項

RED または YELLOW のステータスを受け取った後は、次の手順を実行してください。

1. 一覧表示されたブロッカーまたは警告の詳細を確認します
2. 該当する成果物を更新して問題に対処します
3. /speckit.plan を再実行して plan.md を再生成します
4. planning-validate を再実行して修正内容を確認します