update-project

プロジェクトのドキュメントを、最近のコード変更や git コミットに合わせて更新します。

大きなコード変更の後、リリース前、またはドキュメントが古くなっている可能性がある場合に実行してください。

プロジェクトで実際に変更された内容だけを更新してください。記載する前に、リポジトリ内のファイルを確認して内容を裏付けてください。確認できないセクションはそのままにしてください。

AGENTS.md はエージェント向けの指示ファイルであり、Claude Code、Codex、その他のホストが参照するエージェント間共通の標準です。CLAUDE.md はレガシーとして扱います。既存のものは維持しますが、新規作成はしないでください。コンポーネントのディレクトリも同じように分けます。Claude Code には .claude/、Codex やエージェント間共通のスキルパスを使用するその他のホストには .agents/skills/ を使います。.agents/agents や .agents/rules は作成しないでください。

ルールの概要

ルール	影響度	ファイル
エージェント向けドキュメント（AGENTS.md / CLAUDE.md / README.md）	高	rules/agent-docs.md
コンポーネント（エージェント、スキル、ルール）	中	rules/components.md

ワークフロー

ステップ 1：検出

• git log --oneline -20 と git diff を実行し、最近の変更を特定します
• エージェント向けの指示ファイル（AGENTS.md、CLAUDE.md）が存在するか、また README.md が存在するかを確認します（存在しない場合は作成します）
• .claude/agents/*.md、.claude/skills/*/SKILL.md、.claude/rules/*.md、.agents/skills/*/SKILL.md をスキャンします
• ドキュメントに記載された指示とプロジェクトの実際の状態を照合し、古くなったセクションを見つけます
• 新しいツール、削除された依存関係、変更されたパス、名前が変更されたコマンドに印を付けます

ステップ 2：更新

該当するルールファイルを読み、更新を適用します。

• AGENTS.md / CLAUDE.md / README.md の変更には rules/agent-docs.md
• .claude/ のエージェント、スキル、ルール、および .agents/skills/ には rules/components.md

ステップ 3：検証

• ドキュメントに記載されたプロジェクトのコマンドを実行し、動作を確認します
• 指示が現在のプロジェクト設定と一致しているか確認します
• エージェント向け指示ファイル（AGENTS.md）、README.md、エージェント、スキル、ルールが重複せず、互いを補完していることを確認します
• AGENTS.md と CLAUDE.md の両方が存在する場合は、rules/agent-docs.md に従って、内容が分岐したコピーを維持するのではなく AGENTS.md に統合することを提案します