はじめに¶

C3 を初めて使う方向けのガイド。インストールから最初のセッション完了まで進めます。

前提条件¶

Claude Code で使う場合: Claude Code がインストール済みでログインしていること
Codex で使う場合: Codex CLI または IDE extension が利用できること
Cursor で使う場合: Cursor editor または cursor-agent が利用できること
OpenCode で使う場合: OpenCode が利用できること
Python 3.10 以上 がインストール済みであること
Git が使えること

仮想環境（venv）の準備（推奨）¶

Python の導入方法によっては、素の pip install が PEP 668（externally-managed-environment）により拒否されます（Debian/Ubuntu の apt 版 Python、Homebrew の Python など）。仮想環境（venv）を作ってその中へインストールすれば、この制約を受けずに済みます。

Windows（PowerShell）:

python -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS / Linux:

python3 -m venv .venv
source .venv/bin/activate

venv に入れた場合の注意:

C3 の hook は c3 run で起動されるため、Claude Code を起動するシェルでも同じ venv を activate してください。activate されていないシェルから Claude Code を起動すると c3 が見つからず、hook が動作しません
venv を使わずグローバルに使いたい場合は pipx が代替になります: pipx install claude-code-conductor
インストール後は、Claude Code を起動するのと同じシェルで c3 doctor を実行し、c3 が PATH で解決されることを確認してください（c3 doctor が検査するのは実行中シェルの PATH です。別のシェルで実行しても、Claude Code の hook が起動される文脈は再現できません）

インストール¶

推奨: PyPI から¶

pip install claude-code-conductor

このコマンドが PEP 668（externally-managed-environment）で拒否される場合や、インストール後に hook が動作しない場合は、前提条件の venv 手順（activate するシェルの注意点を含む）を参照してください。

これで c3 CLI と .claude/ テンプレートが入ります。v2.0.0 以降は Claude Code の Agent ツール並列起動と isolation: "worktree" を使うため、別途のプロセスは不要です。

代替: git clone から¶

git clone https://github.com/satoh-y-0323/claude-code-conductor.git

クローンしたリポジトリの .claude/ をプロジェクトにコピーするか、pip install -e . で開発モードで利用できます。

プロジェクトに `.claude/` を展開¶

既存プロジェクトのルートで:

cd /path/to/your-project
c3 init

パッケージ同梱の .claude/ テンプレートがカレントディレクトリへ展開されます。プロジェクトの src/ 等の既存コードには一切触れません。

変更される場所	内容
`.claude/` ディレクトリ（追加）	C3 のフレームワーク一式
`.claude/.gitignore`（自動配置）	再生成可能なもの（`.claude/state/recall.` は数十 MB）とセッション一時ファイルのみ除外。`.claude/agent-memory/`・`.claude/reports/`・`.claude/memory/`・`.claude/state/c3.db` はチームの引き継ぎ資産として tracked（コミット方針）。プロジェクト既存の `.gitignore` は変更しません*

後日 C3 を更新したくなったら:

pip install --upgrade claude-code-conductor
c3 update

c3 update はパッケージ最新版へ差分のみ反映します（reports/ や memory/sessions/ 等の個人ファイルは保持されます）。

Codex / Cursor / OpenCode adapter を追加¶

Claude Code の使い方は従来通りです。Codex/Cursor/OpenCode でも同じ C3 状態を使いたい場合だけ、明示的に adapter を生成します。

c3 init --platform codex
c3 init --platform cursor
c3 init --platform opencode
# まとめて追加する場合
c3 init --platform all

生成後も .claude/ が C3 の canonical source です。

platform	追加される主なファイル
`codex`	`AGENTS.md`, `.agents/skills/`, `.codex/config.toml`, `.codex/agents/`
`cursor`	`.cursor/rules/c3-core.mdc`, `.cursor/mcp.json`
`opencode`	`AGENTS.md`, `.opencode/agents/c3-.md`, `.opencode/agents/c3-skill-.md`

Codex/Cursor adapter は、C3 の AskUserQuestion JSON を MCP tool c3_ask_user_question に渡して単一選択・複数選択を維持します。Claude Code の Agent / Skill tool 前提は、Codex では .codex/agents/ と .agents/skills/、Cursor では .cursor/rules/c3-core.mdc 経由で読み替えます。MCP elicitation が使えない環境では、fallback として c3 ask --file question.json を使えます。OpenCode adapter は MCP を生成せず、AGENTS.md の指示でユーザーに直接確認する方式（@c3-* agent / @c3-skill-* skill を @mention で起動）です。

初回セッション¶

プロジェクトを Claude Code で開き、以下のスラッシュコマンドを順に実行します。

1. `/init-session` — セッション初期化¶

セッション開始時に必ず実行します。前回の作業状態・残タスク・昇格候補パターンを確認できます。

2. `/setup` — プロジェクト規約を設定（初回のみ）¶

/setup

技術スタック・コーディング規約をヒアリングし、以下のファイルを自動生成します:

.claude/rules/coding-standards.md
.claude/rules/project-conventions.md

これらは以降の全セッションで自動的にエージェントへ注入されます。

3. `/start` — 開発開始¶

/start

開始地点（標準ワークフローの各フェーズ / 実装 / デバッグ調査 / レビュー）を選び、対応する dev-workflow フェーズに遷移します（v2.8.0 以降は task_type 概念を廃止し、フェーズを直接選ぶ方式に簡素化）。

5 フェーズの開発ワークフロー¶

/start で開発を始めると、以下の 5 フェーズで進みます。

フェーズ A: ヒアリング    requirements-report を生成
    ↓ 承認
フェーズ B: 設計          architecture-report を生成
    ↓ 承認
フェーズ C: 計画          plan-report を生成
    ↓ 承認（任意で design-critic が設計・計画を監査 → design-review-report）
フェーズ D: TDD           tester → developer → tester のサイクル
    ↓ 承認（自動遷移）
フェーズ E: レビュー      code-reviewer → security-reviewer
    ↓ 指摘あり
フェーズ C へ戻る（内部遷移）

各フェーズの移行時にユーザーが承認・否認・修正を選択します。フェーズ D・E への遷移は承認後に自動で行われます。

終了時の挙動¶

セッション終了時、stop.py フックが自動的に以下を実行します:

session ファイルの記録時刻を更新
Claude の最終応答を事実ログに自動記録（次セッションで「前回何をしたか」が分かる）
patterns.json の信用度を再計算
過去 7 日分のセッション記録を consolidated_summary.md に集約し、古い session.tmp を archive 化

次に読むページ¶

スキル一覧 — 全スキルの一覧
CLI リファレンス — c3 CLI の詳細