AI ターゲットリファレンス

このページの内容: 各 --ai=<target> がインストールするファイルの正確なリストで、CLI ソース（cli/src/commands/init.ts）から導出されています。 日々の使い方 は対応する how-to ガイドを参照（Claude フローは use-with-claude-code.md）。

pentaglyph init <target> --ai=<claude|cursor|copilot|generic>

--ai を省略すると default は generic。他のターゲットは同じ docs/AI_INSTRUCTIONS.md を指す、エディタ固有の auto-load フックをインストールします。

全ターゲット共通でインストールされるもの

--ai に関係なく、全プロジェクトに以下が入ります:

ファイル	目的
`docs/AI_INSTRUCTIONS.md`	AI エージェントが `docs/` を触るときに従うべきプロトコル。これが正本 ―― エディタ固有フックはここを指すだけ
`docs/WORKFLOW.md`	`AI_INSTRUCTIONS.md` が解決する正本の配置 / ライフサイクルルール

下のエディタフックは 追加分 です。working directory が docs/** と一致するときに、ユーザーが思い出させなくても AI エージェントに 自動でプロトコルを読ませる 役割です。

`claude` — 最も統合された形

<target>/
├── .claude/
│   ├── rules/
│   │   ├── documentation.md      ← docs/** 編集時に auto-load
│   │   ├── version-control.md    ← 常時 auto-load（Git Flow + Conventional Commits）
│   │   └── dialogue-style.md     ← 常時 auto-load（consultative dialogue）
│   ├── agents/
│   │   ├── adr-writer.md
│   │   ├── architect-agent.md
│   │   ├── completeness-auditor.md
│   │   ├── discovery-agent.md
│   │   ├── doc-orchestrator.md
│   │   └── spec-writer.md
│   └── skills/
│       ├── diagram-render/
│       ├── doc-fill/
│       ├── doc-init/
│       ├── doc-status/
│       └── explain/

使うとき: チームが Claude Code を主 AI アシスタントとして使っている。

auto-load ルールに加えて得られるもの:

6 つの専門エージェント（orchestrator が dispatch できる） ―― discovery、architecture、ADR drafting、spec writing、completeness auditing
5 つの skill。複数ステップの doc 作業を /doc-init、/doc-fill、/doc-status、/diagram-render、/explain の単一コマンドの後ろに包む
documentation、version-control 規約、dialogue style をカバーする 3 つの auto-load ルール

これは 圧倒的に最強のターゲット です。選択肢があるなら claude を選びましょう。

`cursor` — auto-load のみ

<target>/
└── .cursor/
    └── rules/
        └── docs.md     ← .claude/rules/documentation.md のコピー

使うとき: チームが Cursor を使っている。

得られるもの:

Cursor の working context が docs/** と重なったときに auto-load ルールが起動
docs.md の内容は Claude の documentation.md とビット単位で同一。プロトコルは同じで、エディタが読むファイルパスだけが違う

得られないもの: エージェントと skill は Claude 固有。Cursor には今日（2026-05 時点）等価な surface がありません。

`copilot` — auto-load のみ

<target>/
└── .github/
    └── copilot-instructions.md     ← .claude/rules/documentation.md のコピー

使うとき: チームが GitHub Copilot Chat を主 AI アシスタントとして使っている。

得られるもの:

.github/copilot-instructions.md は GitHub の native auto-load surface で、リポジトリレベルの Copilot 文脈用。このリポの全チャットメッセージにプロトコルが含まれる

得られないもの: エージェント、skill、より広い .claude/ ルールセット。

`generic` — エディタフックなし

<target>/
└── （エディタ固有ファイルなし）

使うとき:

エディタ統合の auto-load surface を持たない AI エージェントを使う（CLI エージェント、カスタム MCP クライアント、self-hosted assistant 等）
プロジェクトのエディタ設定をスッキリ保ちたい

得られるもの: docs/AI_INSTRUCTIONS.md は通常通り出荷される。各セッション開始時にエージェントに手動で読むよう指示が必要:

「docs/AI_INSTRUCTIONS.md を読んで、docs/ を触るときは pentaglyph ルールに従って」

ターゲットの機能一覧

機能	`claude`	`cursor`	`copilot`	`generic`
`docs/AI_INSTRUCTIONS.md` インストール	✅	✅	✅	✅
`docs/**` 編集時の auto-load	✅	✅	✅	—
グローバル auto-load（docs だけでなく）	✅	—	✅	—
version-control + dialogue-style ルール	✅	—	—	—
専門エージェント (6)	✅	—	—	—
Skills (5)	✅	—	—	—

非対称性は避けられません: cursor と copilot は auto-load ルール surface しか持ちません。今日エージェントと skill をサポートする唯一のターゲットは Claude Code です。

`init` 後にターゲットを切り替える

切り替えに re-init は不要。--force --ai=<new-target> で再実行:

bunx --bun @uyuutosa/pentaglyph init . --profile=standard --ai=cursor --force

新ターゲットで再実行すると新ターゲットのファイルがインストールされますが、古いターゲットのものは 削除されません。クリーンな切り替えがしたければ、使わない .claude/ / .cursor/ / .github/copilot-instructions.md を手動で削除。

注意事項

ターゲットは排他的ではありません。チームが混在（Claude も Cursor も）なら、異なる --ai フラグで複数回 init を実行。ターゲット同士は競合しません
cursor と copilot は Claude の documentation.md と 同じ内容 をコピー します。これは意図的 ―― プロトコルはエディタ非依存。将来プロトコルがエディタごとに分岐するなら、本ページもそれを反映するよう更新が必要
エージェントと skill はまだポータブルではありません。.claude/agents/ 配下の 6 専門エージェントは Claude Code の Task tool surface を参照しています。非 Claude 環境ではかなりの適応が必要です

AI ターゲットリファレンス

全ターゲット共通でインストールされるもの

claude — 最も統合された形

cursor — auto-load のみ

copilot — auto-load のみ

generic — エディタフックなし