living-spec-consolidator

ライブ仕様の統合

{specs_root}/ を、製品の最新の機能仕様として維持します。

{specs_root} のデフォルト値は {product_root}/docs/specs/ です。

ハーネスの検出

../nextstage-harness/references/harness-discovery.md と ../nextstage-harness/references/artifact-layout.md を参照してください。

呼び出すタイミング

• バージョン完了ワークフローの後（コードレビュー後）
• そのバージョンの code-review-report.md が存在する前には実行しないでください

前提条件

• {product_root}/docs/versions/{version_san}/requirements.md
• {product_root}/docs/versions/{version_san}/code-review-report.md
• {product_root}/docs/versions/{version_san}/execution-handoff.md（タスク完了済み）

ワークフロー

1. 影響を受けるドメインの特定

機能を正規のドメインに割り当てます（例）。

機能領域	ドメインファイル
認証、ログイン、RBAC	auth.md
ユーザー、プロフィール	users.md
課金	billing.md
通知	notifications.md
レポート	reports.md
インテグレーション	integrations.md
エージェント／グラフ	agent.md

命名規則：英語、ケバブケース、単数形（user-profile.md）。複数のドメインにまたがる機能では、複数の仕様ファイルを更新します。

2. ドメインごとの処理

{specs_root}/{domain}.md が存在しない場合： references/domain-spec.template.md を基に作成します。

存在する場合： 全体を読み、追記または更新します。既存の内容を確認せずに上書きしてはいけません。

関連する各機能について：

• ### Requirement: ブロック（SHALL とシナリオ）を追加または更新します
• スキーマ／API に変更があった場合は、## Data model と ## Endpoints を更新します
• ## Changelog の項目を追記します：**{version_san}** — {ISO date}: {summary}

3. INDEX.md の更新

{specs_root}/INDEX.md を作成または更新します。

# Domain specs — {product_name}

| Domain | File                 | Last updated | Versions      |
| ------ | -------------------- | ------------ | ------------- |
| auth   | `docs/specs/auth.md` | {date}       | {version_san} |

4. 統合レポート

引き継ぎ用の短いレポートを出力します。

## Living specs updated
| Domain | Action | File |
...
Requirements added: N
Requirements updated: N
New specs: N

重要なルール

• 仕様の内容は英語で記述します
• 要件には検証可能な SHALL 形式を使用します
• 既存の仕様ファイルは、書き込む前に読みます
• 計画オーケストレーターは、新しいバージョンの要件を作成する前に INDEX.md を読む必要があります

関連スキル

• requirements-generator — 計画時にライブ仕様を読み込みます
• code-reviewer — 前提条件となる承認