Spec-Driven Docs 基盤の初期化
リポジトリの共有知識基盤（人間とエージェントの両方が読む層）を立ち上げ、残りのスペックパック（spec-create、spec-execute）が書き込む場所を確保します。安全で追加的な操作であり、何も削除せず、ドラフトは確認されるまで推測として扱われ、オーナーが承認して初めて信頼できる情報源となります。
ターゲット構造を解決する（学習、次にプロファイル、次にデフォルト）- 決して押し付けない
- まずプロジェクトから学ぶ。 リポジトリに既にドキュメント構造（
docs/、Documentation/、ドキュメントルール、関連機能のドキュメント）が存在する場合、それを採用します - まず検索し、関連する2つのドキュメントを読み、模倣し、発明しません。成熟した既存の構造がデフォルトよりも優先されます。既に機能しているものを再構築しないでください。 - プロファイルにより、曖昧な場合にパスを固定します：
specs_dir、features_dir、rules_dir、decisions_dir、spec_grouping。 - グリーンフィールドデフォルト = AIファーストドキュメントツリー（
references/docs-tree.mdを参照）：docs/配下にmodel.md、glossary.md、rules/R-NNN-*.md、features/<feature>.md、specs/NNN-<feature>/{requirements,plan,tasks}.md、decisions/NNNN-*.md、architecture/、guides/、_inbox/。
レイヤーモデル（このスキルの管轄）
エージェントを制約する強さの順に並べます。エージェントは、散文よりも実行可能なチェックに確実に従います。
- レイヤーA - 実行可能な制約（lint/バウンダリ/コントラクトテスト設定、
tests/）：最も強力。ここでは対象外 - 別途設定します。 - レイヤーB - 機械可読なルールとアーキテクチャ知識（ルールとしてのコントラクト
rules/R-NNN、依存関係マップ、決定ログ）。spec-init はこれらのドキュメントをスキャフォールディングします。エージェントエントリルーター（AGENTS.md）は同期エンジンが所有し続けます。このスキルは、それがドキュメントツリーを指すようにするだけで、決して上書きしません。 - レイヤーC - 共有知識基盤（モデル、用語集、機能ドキュメント、スペック、アーキテクチャ、ガイド）。spec-init はこれをスキャフォールディングし、シードします。
手順
- 棚卸し 既存のドキュメント：すべての
*.md、Wiki エクスポート、図、散在するメモ。それぞれをモデル / 用語集 / 機能動作 / フロー / 決定 / アーキテクチャ / ガイド / 未分類 に分類します。 - スキャフォールド 解決されたツリー - 不足しているものだけを作成します（フォルダ +
docs/README.mdインデックス）。既存のドキュメントを上書きしないでください。 - 安全に移行 - まず検疫します。 既存の未分類またはレガシーコンテンツをすべて
_inbox/（検疫所）に移動し、新しい構造のみを信頼できる情報源として読み取らせます。その後、オーナーのレビューを得て1つずつ再分類します：