sync-docs

Topics in the source

• Sync Docs Skill
• 対象ドキュメントの決定
• アーキテクチャ
• 手順
• 0. 対象ドキュメントの収集
• 1. サブエージェントを並列起動する
• サブエージェント A — コードベース現状調査
• サブエージェント B — 対象ドキュメント読み込み

コードベースの現状を読み取り、陳腐化した参照用ドキュメントを更新する。 ホスト repo の CLAUDE.md に記載されたドキュメント表（または同等のパス一覧）を読み、対象ファイルを動的に決定する。典型的には以下のような項目が含まれる: README（README.md など） コアコンセプト・アーキテクチャ概要 構文・仕様リファレンス 要求・要件（requirements） API リファレンス 設計記録（ADR・Design Doc）や受け入れテスト記録は 対象外（変更不可な履歴記録のため）。CLAUDE.md が無い repo では、ユーザーに対象ドキュメントを確認する。 2つの Explore エージェントを並列起動して差分を収集し、メインエージェントが更新案を生成する。 CLAUDE.md のドキュメント表をパースし、対象ファイル一覧を生成する。CLAUDE.md が存在しない / ドキュメント表が無い場合は、ユーザーに対象を確認する。 加えて、リポジトリルート直下の README.md 全件（README.md, README.ja.md, README.zh-CN.md 等）も自動的に対象に含める（CLAUDE.md 表で言及が無くても）。サブディレクトリの README.md は再帰しない。README.md を canonical（source of truth） として扱い、それ以外は localized variant とみなす。 以下の2つの Explore エージェントを 同時に（1メッセージで） 起動する。 -- プロンプト（要旨）: ホスト repo のソースルート（host の package.json の workspaces / main / module フィールドや、典型的な src/ packages//src/ 等から検出）を調査し、現在実装されている機能を網羅的に把握せよ。 CLAUDE.md のドキュメント表で挙がっている各ドキュメントが扱うトピックに対応する実装観点で調べ、結果を報告せよ。例えば「構文リファレンス」が表にあるなら lexer / parser を見て対応するキーワード・ブロック・プロパティを抽出し、「要求・要件」が表にあるなら主要な機能・UI コンポーネントを抽出する。 結果は以下の形式で返せ（カテゴリは対象ドキュメントに応じて適宜追加せよ）: CATEGORY|サブキー|説明 例: SYNTAXKEYWORD|キーワード名|説明 SYNTAXBLOCK|ブロック名|説明 FEATURE|機能名|説明 CORETYPE|型名|説明 -- プロンプト（要旨）: 以下のドキュメントをすべて読み込み、各ドキュメントが何を記述しているかを把握せよ。 陳腐化している可能性のある記述（「将来的に」「未

This is an excerpt. Refer to the complete source and its current requirements.