プロジェクトの実態(ディレクトリ構成・依存パッケージ・スクリプト)を読み取り、ルート README.md の各セクションを最新の状態に同期する。
プロジェクトの実態を読み取り、ルート README.md を最新の状態に同期する。
以下のセクションを順にチェック・更新する。$ARGUMENTS で特定セクションが指定された場合はそのセクションのみ対象とする。
以下の情報を並列で収集する:
Glob でワークスペースパッケージのディレクトリを列挙するpackage.json を読み込み、主要な依存を把握するpackage.json の scripts フィールドを読み込むpnpm-workspace.yaml を読み込む.claude/skills/ 配下の SKILL.md を Glob で列挙し、各スキルの frontmatter(name, description)を読み込むルートの README.md を読み込み、各セクションの現状を把握する。
実際のディレクトリ構成と README の plaintext コードブロック内のツリー図を比較する。
チェック項目:
lib/, bin/, agent/, src/, docs/ など)が反映されているか# 説明テキスト)がパッケージの実態と一致しているか差分があった場合: ツリー図を更新する。ツリー図の記法・インデントスタイルは既存のフォーマットを維持する。
各パッケージの package.json の dependencies / devDependencies から主要ツールを抽出し、README の開発環境テーブルと比較する。
主要ツール判定基準:
以下は主要ツールとして含めない:
@types/* パッケージ@smithy/* 等の間接依存)チェック項目:
差分があった場合: テーブルを更新する。カテゴリの並び順は「共通 → 各パッケージ(アルファベット順)」とする。
ルート package.json の scripts と、README のセットアップセクションを比較する。
チェック項目:
scripts に存在するセットアップ系コマンド(*:install 等)が README に記載されているかscripts に存在するか差分があった場合: セットアップ手順を更新する。
ルート package.json の scripts と、README の使用方法セクションを比較する。
チェック項目:
dev:*, build:*, cdk:* 等)が README に記載されているかscripts に存在するか差分があった場合: 使用方法セクションを更新する。新しいコマンドカテゴリがある場合はサブセクションを追加する。
.claude/skills/ 配下のスキル定義と、README の Skills テーブルを比較する。
チェック項目:
SKILL.md の description と一致しているかargument-hint と一致しているか差分があった場合: テーブルを更新する。
すべてのチェックが完了したら、検出した差分を一覧表示してユーザーに確認する。
差分がない場合: README は最新の状態であることを報告して終了する。
差分がある場合: 差分の一覧を表示し、Edit ツールで修正を適用する。
同期完了後、以下の形式でサマリーを出力する:
## README 同期結果サマリー
### 更新したセクション
- [ セクション名: 変更内容 ]
- ...
### 変更なしのセクション
- [ セクション名 ]: 最新の状態 ✅
### ユーザーへの確認事項(ある場合)
- [ 確認事項 ]