AIコンテキストファイルの設定

AIクライアントはそれぞれ異なる名前のファイルをプロジェクト指示書として読み込みます。
本ページでは対応表と、1ファイルだけ管理すれば全ツールに反映されるセットアップ方法を説明します。

クライアント別 対応ファイル

クライアント	読み込むファイル
Claude Code	CLAUDE.md
OpenAI Codex CLI	AGENTS.md
GitHub Copilot	.github/copilot-instructions.md
Cursor	.cursor/rules/*.mdc または .cursorrules
Windsurf	.windsurfrules

推奨構成：CLAUDE.md を SSOT にする

CLAUDE.md を実体（唯一の編集対象）とし、他ファイルはシンボリックリンクで参照させます。

CLAUDE.md                        ← 実体（ここだけ編集）
AGENTS.md                        → CLAUDE.md へのリンク
.cursorrules                     → CLAUDE.md へのリンク
.windsurfrules                   → CLAUDE.md へのリンク
.github/copilot-instructions.md  → CLAUDE.md へのリンク

CLAUDE.md を保存した瞬間、全ツールへ反映されます。スクリプト実行は不要です。

セットアップ手順

1. project_scaffold で一括生成

/mcp__psm__project_scaffold

実行すると以下が生成されます：

生成物	内容
CLAUDE.md	AIコンテキスト実体（PSMセクション含む）
scripts/setup-ai-links.ps1	Windows用 symlink作成スクリプト
scripts/setup-ai-links.sh	Mac/Linux用 symlink作成スクリプト
scripts/sync-ai-context.ps1	symlink非対応環境向けコピースクリプト
.gitignore 追記内容	symlink対象ファイルをgit管理外に

2. セットアップスクリプトを実行（1回のみ）

Windows

# Developer Mode が有効な環境で実行
./scripts/setup-ai-links.ps1

Mac / Linux

bash scripts/setup-ai-links.sh

Developer Mode が無効な場合（Windows）

setup-ai-links.ps1 の代わりに sync-ai-context.ps1 を使用してください。
symlink は作成されませんが、CLAUDE.md の内容を全ファイルにコピーします。
内容を変更したあとに再実行が必要です。

3. git にコミット

git add CLAUDE.md scripts/ .gitignore
git commit -m "chore: add AI context files setup"

symlink 対象ファイル（AGENTS.md 等）は .gitignore により自動除外されます。

チームでの運用

新しいメンバーが参加した場合の手順は以下だけです。

git clone <repository>
./scripts/setup-ai-links.ps1   # Windows
# または
bash scripts/setup-ai-links.sh # Mac/Linux

以後は git pull で CLAUDE.md が更新されれば、各自のリンクを通じて全ツールへ自動反映されます。

CLAUDE.md を誰かが更新 → git push
    ↓
git pull → CLAUDE.md が更新
    ↓
symlink 経由で全ツールに即反映

CLAUDE.md の内容について

project_scaffold が生成する CLAUDE.md には以下が含まれます。

• プロジェクト概要（type / language / framework）
• PSM 接続ルール（ツール・プロンプトの呼び出し方）
• .history/ を使ったナレッジ管理ルーティン
• セッション開始・終了時の手順

チームの規約や開発ルールはこの CLAUDE.md に追記していきます。