ln-111-root-docs-creator

パス： ファイルパス（references/、../ln-*）は、このスキルディレクトリを基準とします。

ルートドキュメント作成者

種類： L3 ワーカー

コーディネーターから受け取ったテンプレートと Context Store を使用して、ルートにある 7 つのドキュメントファイルを作成する L3 ワーカーです。

目的と範囲

• AI エージェントのエントリーポイントとなるルートドキュメントファイルを 7 つ作成します
• ln-110-project-docs-coordinator から Context Store を受け取ります
• プレースホルダーをプロジェクト固有のデータに置き換えます
• 構造と内容を自己検証します（22 項目の質問）
• コンテキストを自ら収集することはありません。コーディネーターからの入力を使用します

入力

コーディネーターから受け取ります：

• contextStore：すべてのプレースホルダーを含むキーと値のペア
  • PROJECT_NAME、PROJECT_DESCRIPTION
  • TECH_STACK_SUMMARY
  • DEV_COMMANDS（package.json のスクリプトから取得）
  • DATE（現在の日付）
  • ENABLE_WORKFLOW_PRINCIPLES（任意のブール値。デフォルトは false）— true の場合、AGENTS.md の {{WORKFLOW_PRINCIPLES_BLOCK}} プレースホルダーを references/templates/agents_md_workflow_principles.md の内容に展開します
• targetDir：プロジェクトのルートディレクトリ

必ず読み込む： references/docs_quality_contract.md と references/agent_instructions_writing_guide.md（AGENTS.md／CLAUDE.md の正式な執筆ガイド）を読み込みます。 任意のルールカタログ：正確なルール ID、パスマトリックス、または許可リストに登録されたプレースホルダーの例外が必要な場合に限り、references/docs_quality_rules.json を読み込みます。

作成するドキュメント

ファイル	対象セクション	質問
AGENTS.md	クイックナビゲーション、エージェントエントリー、重要なルール、（任意）ワークフローの原則、開発コマンド、メンテナンス	Q1-Q6
CLAUDE.md	@AGENTS.md のインポート + ## Claude Code の差分（合計 20 行以下）	Q1-Q6
docs/README.md	クイックナビゲーション、エージェントエントリー、ドキュメントマップ、メンテナンス	Q7-Q13
docs/documentation_standards.md	クイックリファレンス（60 項目以上の要件）、12 のメインセクション、メンテナンス	Q14-Q16
docs/principles.md	コア原則（8 項目）、意思決定フレームワーク、アンチパターン、検証、メンテナンス	Q17-Q22

ワークフロー

フェーズ 1：コンテキストの受け取り

1. コーディネーターから Context Store を解析します
2. 必須キー（PROJECT_NAME、PROJECT_DESCRIPTION）が存在することを検証します
3. 欠落している任意キーにはデフォルト値を設定します（ENABLE_WORKFLOW_PRINCIPLES のデフォルトは false）

フェーズ 2：ドキュメントの作成

各ドキュメント（AGENTS.md、CLAUDE.md、docs/README.md、docs/documentation_standards.md、docs/principles.md）について：

1. ファイルが存在するか確認します（冪等性を保つため）。
2. 存在する場合：ログを記録してスキップします。
3. 存在しない場合：
   • references/templates/ からテンプレートをコピーします。
   • AGENTS.md の場合：共有ヘッダーの契約（SCOPE、DOC_KIND、DOC_ROLE: canonical、READ_WHEN、SKIP_WHEN、PRIMARY_SOURCES）と、冒頭セクションの契約（## Quick Navigation、## Agent Entry、## Critical Rules、## Maintenance）を必ず満たします。
   • AGENTS.md の場合：ENABLE_WORKFLOW_PRINCIPLES=true なら、{{WORKFLOW_PRINCIPLES_BLOCK}} プレースホルダーを references/templates/agents_md_workflow_principles.md の全文で置き換えます。それ以外の場合は、プレースホルダー行とその先頭にあるコメントを削除します。
   • CLAUDE.md の場合：インポートスタブのテンプレート（claude_md_template.md）を使用します。DOC_ROLE: derived、単一の @AGENTS.md 行、範囲を限定したハーネス固有の差分が含まれます。AGENTS.md の内容をインラインで記述しないでください。
   • docs/principles.md の場合：Context Store にすでに存在する正規化済みの原則を優先します。
   • プロジェクト固有の原則がない場合は、テンプレートの構造を維持し、現在のプロジェクトのソースで裏付けられる事実だけを記入します。
   • {{PLACEHOLDER}} トークンを Context Store の値で置き換えます。
   • 公開するルートドキュメントにテンプレートマーカーを残さないでください。
   • データが不足している場合：該当する記述を省くか、簡潔で中立的な代替表現を使用します。ただし、[TBD: ...] は出力しないでください。
   • ファイルを書き込みます。

ルートエントリーポイントのルール（正規モデル）：

• AGENTS.md は、内容の唯一の正規ソースです。Critical Rules テーブル、MCP Tool Preferences、Navigation、Development Commands、任意の Workflow Principles を記載します。
• CLAUDE.md は Claude Code 固有のスタブで、@AGENTS.md と、ハーネス固有のルールを記した ## Claude Code の差分を含みます（合計 20 行以下、絶対上限は 50 行）。AGENTS.md の内容を重複させないでください。
• Claude Code は起動時に @path インポートをセッションコンテキストに展開するため、インポートされた AGENTS.md は自動的に利用可能です。
• ハーネス差分の内容：コマンド用語（/compact、/memory show）、ストレージの場所（~/.claude/projects/<project>/memory/）、Claude 専用機能（paths: フロントマターを含む .claude/rules/、ネストされたオンデマンド読み込み）。

フェーズ 3：自己検証

作成した各ドキュメントについて：

1. 最初の 12 行以内に SCOPE タグがあることを確認します。
2. メタデータマーカー（DOC_KIND、DOC_ROLE、READ_WHEN、SKIP_WHEN、PRIMARY_SOURCES）を確認します。
3. AGENTS.md の場合：Quick Navigation、Agent Entry、Critical Rules、Maintenance を確認します。
4. CLAUDE.md の場合：@AGENTS.md インポート行があり、ファイルが 50 行以下であることを確認します。
5. 必須セクション（questions_root.md に記載）を確認します。
6. ドキュメント品質の契約に準拠していることを確認します（禁止されたプレースホルダーがなく、テンプレートのメタデータが漏れていないこと）。
7. POSIX 形式の改行を確認します（末尾は改行 1 つ）。
8. 可能な場合は問題を自動修正します。

フェーズ 4：ステータスを返す

コーディネーターに以下を返します：

{
  "created_files": ["AGENTS.md", "CLAUDE.md", "docs/README.md", "docs/documentation_standards.md", "docs/principles.md"],
  "skipped_files": [],
  "quality_inputs": {
    "doc_paths": ["AGENTS.md", "CLAUDE.md", "docs/README.md", "docs/documentation_standards.md", "docs/principles.md"],
    "owners": {
      "AGENTS.md": "ln-111-root-docs-creator",
      "CLAUDE.md": "ln-111-root-docs-creator",
      "docs/README.md": "ln-111-root-docs-creator",
      "docs/documentation_standards.md": "ln-111-root-docs-creator",
      "docs/principles.md": "ln-111-root-docs-creator"
    }
  },
  "validation_status": "passed"
}

重要事項

基本ルール

• 冪等性： 既存のファイルを上書きせず、スキップしてログを記録します。
• コンテキスト収集の禁止： すべてのデータはコーディネーターの Context Store から取得します。
• 公開可能な出力： ルートドキュメントに [TBD: ...]、TODO、漏れたテンプレートメタデータを含めてはいけません。
• 言語： すべてのルートドキュメントを英語で記述します（普遍的な標準）。
• SCOPE タグ： 各ファイルの最初の 10 行以内に必須です（HTML コメントは Claude Code の注入コンテキストから削除されますが、保守担当者と監査担当者には表示されます）。
• 正規ソースとスタブによるルートモデル： AGENTS.md が唯一のソースです。CLAUDE.md は @AGENTS.md のインポートと、範囲を限定したハーネス差分で構成されます。根拠とアンチパターンについては references/agent_instructions_writing_guide.md を参照してください。

NO_CODE_EXAMPLES ルール（必須）

ルートドキュメントではナビゲーションと標準を定義し、実装は定義しません。

• 禁止： コードブロック、実装スニペット
• 許可： テーブル、リンク、コマンド例（1 行）
• テンプレートルール： すべてのテンプレートに `` タグが含まれています。必ず従ってください。

スタック適応ルール（必須）

• すべての外部リンクは、プロジェクトのスタック（Context Store で検出）に合わせる必要があります
• .NET プロジェクト → Microsoft のドキュメント、Node.js → MDN、npm のドキュメント、Python → Python のドキュメント
• スタックの参照を混在させないでください（.NET プロジェクトに Python の例を含めない）

形式の優先順位（必須）

表／ASCII ＞ リスト（列挙のみ）＞ テキスト（最後の手段）

ランタイム概要アーティファクト

必ず読むこと： references/docs_generation_summary_contract.md を読み込みます

summaryArtifactPath は任意で指定できます。

概要の種類：

• docs-generation

必須のペイロードセマンティクス：

• worker = "ln-111"
• status
• created_files
• skipped_files
• quality_inputs
• validation_status
• warnings

指定されたアーティファクトパスに概要を書き込むか、構造化出力で同じエンベロープを返します。

完了の定義

• Context Store を受け取り、検証済みである
• ルートドキュメントを作成済み（または既存の場合はスキップ済み）である
• すべてのプレースホルダーを置換済みであり、ルートドキュメントに [TBD: ...] マーカーやテンプレートメタデータが残っていない
• CLAUDE.md に @AGENTS.md の行が正確に1つ含まれ、ハーネスの追加内容が上限内（合計≤50行）である
• ENABLE_WORKFLOW_PRINCIPLES=true の場合：ワークフロー原則のシャードを AGENTS.md に展開済みである。false の場合：プレースホルダー行を削除済みである
• 自己検証に合格している（SCOPE、メタデータマーカー、トップセクション、Maintenance、POSIX）
• 最新性を検証済み： ドキュメント内のすべての事実が現在のコードと一致している（パス、関数、API、設定が存在し、正確である）
• ステータスを返している

参照ファイル

• テンプレート：references/templates/agents_md_template.md、references/templates/claude_md_template.md、references/templates/agents_md_workflow_principles.md、references/templates/docs_root_readme_template.md、references/templates/documentation_standards_template.md、references/templates/principles_template.md
• 質問：references/questions_root.md（Q1-Q22）
• 執筆ガイド： references/agent_instructions_writing_guide.md（@AGENTS.md インポートパターン、サイズ上限、アンチパターンの標準的な根拠）
• 環境状態： references/environment_state_contract.md（検出とブートストラップのパターン）

---

バージョン： 2.1.0 最終更新日： 2025-01-12