analyze-consistency

一貫性の分析

実行前の検証：コーディング前に計画同士を照合します。

ハーネスの検出

../nextstage-harness/references/harness-discovery.md を参照してください。{harness_root}/rules/*.md からルールを読み込みます。最初に architecture-rules.md を読んでください。レガシー対応：{harness_root} が存在しない場合に限り、.cursor/rules/*.mdc を使用します。

使用するタイミング

• Gate 2（scope_confirmed）の後
• ユーザーが「要件を分析」または「一貫性を確認」と依頼したとき
• requirements.md を手動で編集した後

前提条件

• {product_root}/docs/versions/{version_san}/requirements.md が存在する
• レポートを書き込む前に、バージョンディレクトリが存在しない場合は作成する

ワークフロー

Step 1 — 要件の索引化

requirements.md を読み、以下を索引化します。

• 主な目的
• 機能（タイトル、優先順位、受け入れ基準）
• NFR
• 宣言された技術スタック

Step 2 — チェックの実行

それぞれを ✅ OK | ⚠️ 警告 | ❌ ブロッカー に分類します。

機能の完全性

チェック	失敗レベル
すべての機能にタイトル、説明、受け入れ基準がある	❌ ブロッカー
各機能に受け入れ基準が2つ以上ある	⚠️ 警告
循環する優先順位がない	❌ ブロッカー
ルート機能（優先順位の依存先がない機能）が1つ以上ある	❌ ブロッカー
E2E が想定されるフロントエンド機能にテスト ID が記載されている	⚠️ 警告

テストカバレッジ

チェック	失敗レベル
バックエンド機能に単体テストの基準が含まれている	⚠️ 警告
UI 機能に E2E の基準が含まれている	⚠️ 警告
グリーンフィールドではドメインより先にインフラがある	⚠️ 警告

データモデル

チェック	失敗レベル
明確な「データモデルと API」セクションがある	❌ ブロッカー
機能に記載されたすべてのエンティティがデータモデルに列挙されている	❌ ブロッカー
外部キーの作成順序が守られている	❌ ブロッカー
フロントエンドで利用する API エンドポイントが宣言されている	❌ ブロッカー

整合性

チェック	失敗レベル
機能が明示された目的を支えている	⚠️ 警告
スコープ外の機能が含まれている	⚠️ 警告

ハーネスルールにスタック固有のチェックがある場合は適用します（Laravel／React のチェックは任意です）。

Step 3 — レポート

以下に保存します：{product_root}/docs/versions/{version_san}/consistency-report.md

# Consistency Report — {version_san}

**Date:** {date}
**Analyzed:** `{path}`

## Overall result

✅ 100% approved | ⚠️ Approved with reservations | ❌ Requires correction

## Blockers (❌)

...

## Warnings (⚠️)

...

## Passed (✅)

Count and summary

## Recommendations

Optional improvements

Step 4 — 続行の判断

• ❌ ブロッカー： 停止します。要件を修正するようユーザーに依頼してから、再実行してください
• ⚠️ 警告のみ： 今すぐ修正するか、そのまま続行するかを確認します。判断はユーザーに委ねます
• ✅ 100%： タスク生成へ自動的に進むことを伝えます。execution_confirmed は暗黙に確定したものとして扱います（Gate 3 をスキップ）

重要なルール

• requirements.md は編集しないでください。問題をレポートするだけにします
• 修正または明示的な免除がない限り、ブロッカーがあるとタスク生成はできません
• 要件がない場合は Gate 1／requirements-generator に戻します

統合

Gate 2 → analyze-consistency → [100%] → task-generator
                            → [blockers] → fix requirements

実装後：code-reviewer が要件とコードの整合性を検証します。これは補完的なものであり、代替ではありません。