claude-code-conductor 2.29.4__tar.gz → 2.30.0__tar.gz

{claude_code_conductor-2.29.4 → claude_code_conductor-2.30.0}/.claude/CLAUDE.md

@@ -53,15 +53,15 @@
 
 ## Platform Compatibility
 
-このファイルは Claude Code / Codex / Cursor から canonical source として読まれる。
+このファイルは Claude Code / Codex / Cursor / OpenCode から canonical source として読まれる。
 他プラットフォームでの動作差分は以下の通り:
 
-- **`AskUserQuestion`** への参照は、Codex/Cursor では MCP tool `c3_ask_user_question` に読み替える（MCP elicitation 非対応時の fallback は `c3 ask --file <json>`）
-- **`Agent` ツール** の参照は、Codex では `.codex/agents/<name>.toml` 経由のサブエージェント、Cursor では現行 runtime のサブエージェント機構（無い場合は同一 agent 内でフェーズ実行しレポート契約のみ維持）に読み替える
-- **`Skill` ツール / `/<skill>`** の参照は、Codex では `.agents/skills/<name>/SKILL.md`、Cursor では `.claude/skills/<name>/SKILL.md` を直接読み込む（スラッシュコマンド自動展開は Claude Code 専用機能）
-- **`isolation: worktree`** / **`permissionMode`** / **`tools` 制限** など agent フロントマターの一部キーは Claude Code 仕様。adapter 側では読み替え不能なものは無視される
+- **`AskUserQuestion`** への参照は、Codex/Cursor では MCP tool `c3_ask_user_question` に読み替える（MCP elicitation 非対応時の fallback は `c3 ask --file <json>`）。OpenCode では MCP を生成しないため、`AGENTS.md` の指示に従ってユーザーへ直接確認する（`multiSelect: true` は複数選択の質問として維持）
+- **`Agent` ツール** の参照は、Codex では `.codex/agents/<name>.toml` 経由のサブエージェント、Cursor では現行 runtime のサブエージェント機構（無い場合は同一 agent 内でフェーズ実行しレポート契約のみ維持）、OpenCode では `.opencode/agents/c3-<name>.md` を `@mention` で起動するサブエージェントに読み替える
+- **`Skill` ツール / `/<skill>`** の参照は、Codex では `.agents/skills/<name>/SKILL.md`、Cursor では `.claude/skills/<name>/SKILL.md` を直接読み込む。OpenCode では `.opencode/agents/c3-skill-<name>.md`（`.claude/skills/<name>/SKILL.md` を本文に埋め込み済み）を `@mention` で起動する（スラッシュコマンド自動展開は Claude Code 専用機能）
+- **`isolation: worktree`** / **`permissionMode`** / **`tools` 制限** など agent フロントマターの一部キーは Claude Code 仕様。adapter 側では読み替え不能なものは無視される（OpenCode adapter は全 agent に `bash/read/edit/write/websearch` を一律付与する）
 
-レポート（`.claude/reports/`）・state（`.claude/state/`）・memory（`.claude/agent-memory/`）のファイル名と書き込み先は全プラットフォーム共通。adapter 生成物の詳細は `c3 init --platform codex|cursor` で出力される `AGENTS.md` / `.cursor/rules/c3-core.mdc` を参照。
+レポート（`.claude/reports/`）・state（`.claude/state/`）・memory（`.claude/agent-memory/`）のファイル名と書き込み先は全プラットフォーム共通。adapter 生成物の詳細は `c3 init --platform codex|cursor|opencode` で出力される `AGENTS.md` / `.cursor/rules/c3-core.mdc` / `.opencode/agents/` を参照。
 
 ---
 

{claude_code_conductor-2.29.4 → claude_code_conductor-2.30.0}/.claude/docs/platform-adapters.md

@@ -1,7 +1,7 @@
 # Platform Adapters
 
 C3 は **Claude Code** を canonical platform として設計されているが、
-`c3 init --platform` で Codex / Cursor 向けの adapter を生成し、同じ `.claude/`
+`c3 init --platform` で Codex / Cursor / OpenCode 向けの adapter を生成し、同じ `.claude/`
 ツリーを共通の source of truth として利用できる。
 
 本ドキュメントは:
@@ -22,6 +22,7 @@ C3 は **Claude Code** を canonical platform として設計されているが
 | `claude` (デフォルト) | `.claude/` のみ | Claude Code ネイティブ |
 | `codex` | `.claude/` + `AGENTS.md` + `.codex/` + `.agents/` | Codex CLI / 職場 Codex |
 | `cursor` | `.claude/` + `.cursor/` | Cursor IDE |
+| `opencode` | `.claude/` + `AGENTS.md` + `.opencode/` | OpenCode |
 | `all` | 上記すべて | マルチプラットフォーム共存 |
 
 `c3 init --platform claude` 以外でも `.claude/` は canonical source として残り、
@@ -51,6 +52,16 @@ adapter は派生ファイルを生成するのみ（`.claude/` の中身を変
 | `.cursor/rules/c3-core.mdc` | Cursor の rule。`alwaysApply: true` で C3 workflow を常時参照 | `_cursor_core_rule` の静的テキスト |
 | `.cursor/mcp.json` | Cursor の MCP サーバー設定。`mcpServers.c3` のみ管理対象 | `_write_cursor_mcp` で既存 JSON にマージ |
 
+### `opencode` 選択時
+
+| パス | 内容 | 生成ロジック |
+|---|---|---|
+| `AGENTS.md` | プロジェクト直下。OpenCode に C3 workflow の存在と `@c3-*` agent の使い方を伝える | `_opencode_agents_section` を managed block で挿入（Codex とは別マーカー） |
+| `.opencode/agents/c3-<name>.md` | `.claude/agents/<name>.md` から生成した OpenCode agent 定義 | `_opencode_agent_md`。`interviewer`/`architect`/`planner` は `mode: all-purpose`、他は `mode: subagent` |
+| `.opencode/agents/c3-skill-<name>.md` | `.claude/skills/<name>/SKILL.md` を OpenCode agent として変換 | `_skill_to_opencode_agent_md`。`mode: all-purpose` 固定 |
+
+> OpenCode adapter は MCP 設定ファイルを生成しない。`AskUserQuestion` は OpenCode 上でユーザーに直接確認する方式（`AGENTS.md` の adapter 指示で `multiSelect: true` を維持）。
+
 ---
 
 ## 3. MCP server (`c3.mcp_server`)
@@ -140,22 +151,22 @@ managed block は使わず、`mcpServers.c3` キーだけを上書き。他の
 
 ## 6. 動作差分まとめ
 
-| 機能 | Claude Code | Codex | Cursor |
-|---|---|---|---|
-| `AskUserQuestion` | ネイティブツール | MCP `c3_ask_user_question` / fallback `c3 ask` | 同左 |
-| `Agent` ツール | ネイティブ subagent | `.codex/agents/<name>.toml` 経由の subagent | runtime に subagent 機構があれば使用、無ければ同一 agent 内でフェーズ実行 |
-| `Skill` ツール / `/<skill>` | ネイティブ | `.agents/skills/<name>/SKILL.md` を読む | `.claude/skills/<name>/SKILL.md` を rule から指示 |
-| `isolation: worktree` | サポート | 一部 Codex runtime で対応、不可時は同一 worktree 実行 | 反映されない |
-| `permissionMode` | サポート | 概念なし（無視） | 概念なし（無視） |
-| `tools` 制限 | サポート | Codex subagent のツール制限に部分対応 | rule テキスト内で補完 |
-| `hooks` (lifecycle) | サポート | 非対応（無視） | 非対応（無視） |
-| `memory` (`MEMORY.md` 注入) | サポート | `.claude/agent-memory/` を共通参照 | 同左 |
-| パターン昇格 (`/promote-pattern`) | ネイティブ | `c3 init --platform codex` 後は `.agents/skills/promote-pattern/SKILL.md` を読んで実行 | rule から `.claude/skills/promote-pattern/SKILL.md` を指示 |
-| レポート (`.claude/reports/`) | 共通 | 共通 | 共通 |
-| state (`.claude/state/`) | 共通 | 共通 | 共通 |
+| 機能 | Claude Code | Codex | Cursor | OpenCode |
+|---|---|---|---|---|
+| `AskUserQuestion` | ネイティブツール | MCP `c3_ask_user_question` / fallback `c3 ask` | 同左 | `AGENTS.md` の指示でユーザーに直接確認（`multiSelect` 維持） |
+| `Agent` ツール | ネイティブ subagent | `.codex/agents/<name>.toml` 経由の subagent | runtime に subagent 機構があれば使用、無ければ同一 agent 内でフェーズ実行 | `.opencode/agents/c3-<name>.md` を `@mention` で起動 |
+| `Skill` ツール / `/<skill>` | ネイティブ | `.agents/skills/<name>/SKILL.md` を読む | `.claude/skills/<name>/SKILL.md` を rule から指示 | `.opencode/agents/c3-skill-<name>.md`（本文に `.claude/skills/<name>/SKILL.md` を埋め込み） |
+| `isolation: worktree` | サポート | 一部 Codex runtime で対応、不可時は同一 worktree 実行 | 反映されない | 反映されない |
+| `permissionMode` | サポート | 概念なし（無視） | 概念なし（無視） | 概念なし（無視） |
+| `tools` 制限 | サポート | Codex subagent のツール制限に部分対応 | rule テキスト内で補完 | 全 agent に `bash/read/edit/write/websearch` を付与 |
+| `hooks` (lifecycle) | サポート | 非対応（無視） | 非対応（無視） | 非対応（無視） |
+| `memory` (`MEMORY.md` 注入) | サポート | `.claude/agent-memory/` を共通参照 | 同左 | 同左 |
+| パターン昇格 (`/promote-pattern`) | ネイティブ | `c3 init --platform codex` 後は `.agents/skills/promote-pattern/SKILL.md` を読んで実行 | rule から `.claude/skills/promote-pattern/SKILL.md` を指示 | `.opencode/agents/c3-skill-promote-pattern.md` を `@mention` |
+| レポート (`.claude/reports/`) | 共通 | 共通 | 共通 | 共通 |
+| state (`.claude/state/`) | 共通 | 共通 | 共通 | 共通 |
 
 レポート・state・memory のファイル名と書き込み先は全プラットフォーム共通。これにより
-Claude Code / Codex / Cursor が同じプロジェクトを行き来しても workflow 状態が保たれる。
+Claude Code / Codex / Cursor / OpenCode が同じプロジェクトを行き来しても workflow 状態が保たれる。
 
 ---
 
@@ -164,4 +175,6 @@ Claude Code / Codex / Cursor が同じプロジェクトを行き来しても wo
 - **`AskUserQuestion` の `multiSelect: true`**: MCP elicitation の仕様上、ホストが multi-select UI に対応していない場合は単一選択に degrade される。`c3 ask --file` の fallback は multi-select に対応
 - **Cursor の subagent**: 2026-05 時点で Cursor は dedicated subagent 機構が限定的。adapter は「同一 agent でフェーズ実行・レポート契約を維持」を方針とする
 - **Codex の `isolation: worktree`**: Codex 側の subagent runtime に依存。worktree 非対応の場合は無視される
+- **OpenCode の `AskUserQuestion`**: OpenCode adapter は MCP 設定を生成しないため、`c3_ask_user_question` ツールは使わず `AGENTS.md` の指示に従ってユーザーへ直接確認する。`multiSelect: true` は「複数選択の質問」として維持するよう指示済み
+- **OpenCode の `tools` 制限**: 生成される agent には一律で `bash/read/edit/write/websearch` を付与する。Claude 側 frontmatter の細かな `tools` 制限は反映されない（C3 の `code-reviewer` / `security-reviewer` は Claude 側でもレポート出力のため `write` を持つ）
 - **改行コード**: adapter 生成ファイルは LF 改行で書き出す（`newline="\n"`）。`.gitattributes` で `eol=lf` を固定済み

{claude_code_conductor-2.29.4 → claude_code_conductor-2.30.0}/ARCHITECTURE.md

@@ -217,13 +217,14 @@ recall_chunker.py  →  embedding.py            →  recall_index.py
 
 ## 6. クロスプラットフォーム adapter
 
-`.claude/` を canonical source としたまま、Codex / Cursor 向けの派生生成物を作る。
+`.claude/` を canonical source としたまま、Codex / Cursor / OpenCode 向けの派生生成物を作る。
 
 | プラットフォーム | 生成物 | 生成コマンド |
 |---|---|---|
 | Claude Code | `.claude/`（primary） | — |
 | Codex | `/AGENTS.md` / `.codex/` / `.agents/skills/` | `c3 init --platform codex` |
 | Cursor | `.cursor/rules/c3-core.mdc` / `.cursor/mcp.json` | `c3 init --platform cursor` |
+| OpenCode | `/AGENTS.md` / `.opencode/agents/` | `c3 init --platform opencode` |
 
 - 生成ロジック: `adapters.py` + `platforms.py`。adapter 生成物は **派生物**（直接編集すると再生成で上書き・配布元 `.gitignore` で除外）。
 - `AskUserQuestion` 互換: MCP tool `c3_ask_user_question`（`mcp_server.py`）、非対応時の fallback は `c3 ask`（`cli_ask.py`）。

{claude_code_conductor-2.29.4 → claude_code_conductor-2.30.0}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [2.30.0] - 2026-06-02
+
+**新プラットフォーム adapter（機能追加・破壊的変更なし）**: `c3 init --platform opencode` で [OpenCode](https://opencode.ai) 向けの adapter を生成できるようになった。`.claude/` を canonical source としたまま、`AGENTS.md`（C3 専用 managed block）と `.opencode/agents/c3-*.md` / `.opencode/agents/c3-skill-*.md` を派生生成する。外部コントリビューター（PR #3 / @ma2tak）の実装に、C3 側でテスト・ドキュメント整備を追加してリリースする。
+
+### 追加
+
+- **OpenCode adapter（`c3 init --platform opencode`）**: `SUPPORTED_PLATFORMS` に `opencode` を追加。生成物は (1) `AGENTS.md` に C3 workflow の存在と `@c3-*` agent の使い方を記す managed block（Codex とは別マーカー `<!-- BEGIN/END C3 OPENCODE ADAPTER -->`）、(2) `.claude/agents/<name>.md` から変換した `.opencode/agents/c3-<name>.md`（`interviewer`/`architect`/`planner` は `mode: all-purpose`、他は `mode: subagent`）、(3) `.claude/skills/<name>/SKILL.md` から変換した `.opencode/agents/c3-skill-<name>.md`（`mode: all-purpose`）。`c3 init --platform all` にも含まれる。
+- **OpenCode adapter のテスト（`tests/test_adapters.py`）**: 外部 contract から書く既存方針に倣い、`_opencode_agent_md` の必須キーと mode マッピング（interactive 3 種 / その他）、`_skill_to_opencode_agent_md`、`_opencode_agents_section` の rules / CLAUDE.md 注入と空時の省略、`scaffold_adapters((opencode,))` の生成ファイル・managed block・冪等性・`.claude/` 不在時 `FileNotFoundError` を固定する回帰テストを追加。
+
+### 動作仕様（既知の差分）
+
+- **MCP を生成しない**: OpenCode adapter は `.codex/config.toml` / `.cursor/mcp.json` のような MCP 設定を作らない。`AskUserQuestion` は `AGENTS.md` の指示に従ってユーザーへ直接確認する方式（`multiSelect: true` は複数選択の質問として維持）。
+- **`tools` 一律付与**: 生成される agent / skill には一律で `bash/read/edit/write/websearch` を付与する。Claude 側 frontmatter の細かな `tools` 制限は反映されない（C3 の `code-reviewer` / `security-reviewer` は Claude 側でもレポート出力のため `write` を持つ）。
+
+### ドキュメント
+
+- `.claude/docs/platform-adapters.md`（§1 選択肢・§2 生成物・§6 動作差分・§7 既知の制限）、`.claude/CLAUDE.md`（Platform Compatibility）、`README.md`、`docs/cli-reference.md`、`docs/getting-started.md`、`ARCHITECTURE.md` に `opencode` を追記。
+
+### 後方互換
+
+- 既存プラットフォーム（claude / codex / cursor）の生成物・挙動に変更なし。`opencode` は明示指定（または `all`）時のみ生成される追加機能。**破壊的変更なし**・migration 不要。
+
 ## [2.29.4] - 2026-05-31
 
 **ドキュメント PATCH（コード変更・破壊的変更・migration なし）**: Anthropic 公式「Prompting best practices」（Claude Opus 4.8 / Sonnet 4.6 等の最新モデル向け）の推奨を C3 の agent 定義に反映。`code-reviewer` / `security-reviewer` / `developer` / `wt_developer` の 4 定義にプロンプト文言を 1 行ずつ追加した。コード・公開 API・DB スキーマに変更なし。

{claude_code_conductor-2.29.4 → claude_code_conductor-2.30.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.29.4
+Version: 2.30.0
 Summary: Multi-agent orchestration framework for Claude Code with Codex/Cursor adapters (C3)
 Project-URL: Homepage, https://github.com/satoh-y-0323/claude-code-conductor
 Project-URL: Repository, https://github.com/satoh-y-0323/claude-code-conductor
@@ -192,7 +192,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | コマンド | 役割 |
 |---|---|
 | `c3 init` | 利用先プロジェクトに `.claude/` を展開する |
-| `c3 init --platform codex|cursor|all` | `.claude/` を canonical source にしたまま Codex/Cursor adapter を追加 |
+| `c3 init --platform codex|cursor|opencode|all` | `.claude/` を canonical source にしたまま Codex/Cursor/OpenCode adapter を追加 |
 | `c3 update` | `.claude/` をパッケージ最新版へ更新する（個人ファイルはスキップ） |
 | `c3 list-agents` / `list-skills` | 設置済みアセットを一覧表示 |
 | `c3 doctor` | 環境診断（`.claude/`・settings.json・claude バイナリ・adapter 生成物） |
@@ -262,14 +262,15 @@ c3 init
 
 `c3 init` がパッケージに同梱された `.claude/` テンプレートをカレントディレクトリへコピーします。後日テンプレート側を更新したい場合は `c3 update` で差分のみ反映できます（`reports/` や `memory/sessions/` 等の個人ファイルは保持されます）。
 
-Codex/Cursor でも同じ C3 workflow を使う場合は、`.claude/` を動かさず adapter を追加します。
+Codex/Cursor/OpenCode でも同じ C3 workflow を使う場合は、`.claude/` を動かさず adapter を追加します。
 
 ```bash
-c3 init --platform codex   # AGENTS.md / .agents/skills / .codex を生成
-c3 init --platform cursor  # .cursor/rules / .cursor/mcp.json を生成
+c3 init --platform codex     # AGENTS.md / .agents/skills / .codex を生成
+c3 init --platform cursor    # .cursor/rules / .cursor/mcp.json を生成
+c3 init --platform opencode  # AGENTS.md / .opencode/agents を生成
 ```
 
-Codex/Cursor adapter は `.claude/skills` と `.claude/agents` を参照元にします。`AskUserQuestion` は MCP tool `c3_ask_user_question`、または fallback の `c3 ask` で単一選択・複数選択を維持します。Claude Code の `Agent` / `Skill` tool 前提は、Codex では `.codex/agents/` と `.agents/skills/`、Cursor では `.cursor/rules/c3-core.mdc` で読み替えます。
+Codex/Cursor/OpenCode adapter は `.claude/skills` と `.claude/agents` を参照元にします。`AskUserQuestion` は MCP tool `c3_ask_user_question`、または fallback の `c3 ask` で単一選択・複数選択を維持します（OpenCode は MCP を生成せず `AGENTS.md` の指示でユーザーに直接確認）。Claude Code の `Agent` / `Skill` tool 前提は、Codex では `.codex/agents/` と `.agents/skills/`、Cursor では `.cursor/rules/c3-core.mdc`、OpenCode では `.opencode/agents/` の `@c3-*` で読み替えます。
 
 **3. プロジェクトを Claude Code で開き、初期設定を行う**
 

{claude_code_conductor-2.29.4 → claude_code_conductor-2.30.0}/README.md

@@ -145,7 +145,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | コマンド | 役割 |
 |---|---|
 | `c3 init` | 利用先プロジェクトに `.claude/` を展開する |
-| `c3 init --platform codex|cursor|all` | `.claude/` を canonical source にしたまま Codex/Cursor adapter を追加 |
+| `c3 init --platform codex|cursor|opencode|all` | `.claude/` を canonical source にしたまま Codex/Cursor/OpenCode adapter を追加 |
 | `c3 update` | `.claude/` をパッケージ最新版へ更新する（個人ファイルはスキップ） |
 | `c3 list-agents` / `list-skills` | 設置済みアセットを一覧表示 |
 | `c3 doctor` | 環境診断（`.claude/`・settings.json・claude バイナリ・adapter 生成物） |
@@ -215,14 +215,15 @@ c3 init
 
 `c3 init` がパッケージに同梱された `.claude/` テンプレートをカレントディレクトリへコピーします。後日テンプレート側を更新したい場合は `c3 update` で差分のみ反映できます（`reports/` や `memory/sessions/` 等の個人ファイルは保持されます）。
 
-Codex/Cursor でも同じ C3 workflow を使う場合は、`.claude/` を動かさず adapter を追加します。
+Codex/Cursor/OpenCode でも同じ C3 workflow を使う場合は、`.claude/` を動かさず adapter を追加します。
 
 ```bash
-c3 init --platform codex   # AGENTS.md / .agents/skills / .codex を生成
-c3 init --platform cursor  # .cursor/rules / .cursor/mcp.json を生成
+c3 init --platform codex     # AGENTS.md / .agents/skills / .codex を生成
+c3 init --platform cursor    # .cursor/rules / .cursor/mcp.json を生成
+c3 init --platform opencode  # AGENTS.md / .opencode/agents を生成
 ```
 
-Codex/Cursor adapter は `.claude/skills` と `.claude/agents` を参照元にします。`AskUserQuestion` は MCP tool `c3_ask_user_question`、または fallback の `c3 ask` で単一選択・複数選択を維持します。Claude Code の `Agent` / `Skill` tool 前提は、Codex では `.codex/agents/` と `.agents/skills/`、Cursor では `.cursor/rules/c3-core.mdc` で読み替えます。
+Codex/Cursor/OpenCode adapter は `.claude/skills` と `.claude/agents` を参照元にします。`AskUserQuestion` は MCP tool `c3_ask_user_question`、または fallback の `c3 ask` で単一選択・複数選択を維持します（OpenCode は MCP を生成せず `AGENTS.md` の指示でユーザーに直接確認）。Claude Code の `Agent` / `Skill` tool 前提は、Codex では `.codex/agents/` と `.agents/skills/`、Cursor では `.cursor/rules/c3-core.mdc`、OpenCode では `.opencode/agents/` の `@c3-*` で読み替えます。
 
 **3. プロジェクトを Claude Code で開き、初期設定を行う**
 

{claude_code_conductor-2.29.4 → claude_code_conductor-2.30.0}/src/c3/__init__.py

@@ -1,3 +1,3 @@
 """Claude Code Conductor (C3) - multi-agent orchestration framework for Claude Code."""
 
-__version__ = "2.29.4"
+__version__ = "2.30.0"

{claude_code_conductor-2.29.4 → claude_code_conductor-2.30.0}/src/c3/adapters.py

@@ -1,4 +1,4 @@
-"""Generate Codex and Cursor adapter files from the canonical ``.claude/`` tree."""
+"""Generate Codex, Cursor, and OpenCode adapter files from the canonical ``.claude/`` tree."""
 
 from __future__ import annotations
 
@@ -14,11 +14,73 @@ import yaml
 
 from c3._excludes import should_skip
 
+# ---------------------------------------------------------------------------
+# Managed-block marker constants (CR L-04: defined before helpers that use them)
+# ---------------------------------------------------------------------------
+
 MANAGED_CODEX_BEGIN = "<!-- BEGIN C3 CODEX ADAPTER -->"
 MANAGED_CODEX_END = "<!-- END C3 CODEX ADAPTER -->"
+MANAGED_OPENCODE_BEGIN = "<!-- BEGIN C3 OPENCODE ADAPTER -->"
+MANAGED_OPENCODE_END = "<!-- END C3 OPENCODE ADAPTER -->"
 MANAGED_CODEX_TOML_BEGIN = "# BEGIN C3 CODEX ADAPTER"
 MANAGED_CODEX_TOML_END = "# END C3 CODEX ADAPTER"
 
+# All Markdown managed-block delimiter strings across every adapter platform
+# (SR-AI-001). Used by _sanitize_for_managed_block to strip any marker regardless
+# of platform. The TOML markers (MANAGED_CODEX_TOML_BEGIN/END) are intentionally
+# excluded: they delimit blocks in .codex/config.toml, never in the Markdown
+# content (CLAUDE.md / rules) that _sanitize_for_managed_block operates on.
+_ALL_MANAGED_MARKERS = (
+    MANAGED_CODEX_BEGIN,
+    MANAGED_CODEX_END,
+    MANAGED_OPENCODE_BEGIN,
+    MANAGED_OPENCODE_END,
+)
+
+# ---------------------------------------------------------------------------
+# YAML / sanitization helpers
+# ---------------------------------------------------------------------------
+
+
+def _yaml_inline_scalar(value: str) -> str:
+    """Return *value* as a YAML-safe inline scalar (single-line, no trailing newline).
+
+    Uses ``yaml.safe_dump`` so that special characters (colons, double-quotes,
+    newlines) are automatically quoted in a way that round-trips cleanly.
+    The trailing newline and optional YAML document-end marker (``...``) that
+    ``safe_dump`` appends are stripped so the result can be embedded directly
+    after ``key: `` in a YAML frontmatter line.
+    """
+    dumped = yaml.safe_dump(value, default_flow_style=True, allow_unicode=True)
+    result = dumped.strip()
+    # safe_dump may append '\n...' as a document-end marker; remove it.
+    if result.endswith("\n..."):
+        result = result[:-4].rstrip()
+    return result
+
+
+def _sanitize_for_managed_block(content: str) -> str:
+    """Strip lines that could corrupt a managed block boundary.
+
+    Removes:
+    - Lines that are exactly any CODEX or OPENCODE managed-block marker string
+      (``MANAGED_CODEX_BEGIN``, ``MANAGED_CODEX_END``, ``MANAGED_OPENCODE_BEGIN``,
+      ``MANAGED_OPENCODE_END``).  Stripping all adapter markers prevents stray
+      delimiter lines from escaping a managed block when platform=all is used
+      (SR-AI-001 / CR M-03 / CR-NEW-01).
+    - Lines whose first character is ``@`` (Claude Code ``@``-include directives
+      such as ``@rules/promoted/index.md`` that are not meaningful to OpenCode
+      and could confuse parsers).
+    """
+    clean_lines: list[str] = []
+    for line in content.splitlines():
+        if line in _ALL_MANAGED_MARKERS:
+            continue
+        if line.startswith("@"):
+            continue
+        clean_lines.append(line)
+    return "\n".join(clean_lines)
+
 
 @dataclass(frozen=True)
 class AdapterAction:
@@ -43,6 +105,8 @@ def scaffold_adapters(
         actions.extend(_write_codex_adapter(target_root, dry_run=dry_run))
     if "cursor" in platforms:
         actions.extend(_write_cursor_adapter(target_root, dry_run=dry_run))
+    if "opencode" in platforms:
+        actions.extend(_write_opencode_adapter(target_root, dry_run=dry_run))
     return actions
 
 
@@ -56,6 +120,23 @@ def print_adapter_actions(actions: list[AdapterAction], *, dry_run: bool = False
         print(f"  {action.action}: {action.path}")
 
 
+def _write_opencode_adapter(target_root: Path, *, dry_run: bool) -> list[AdapterAction]:
+    """Generate the three OpenCode adapter artefacts:
+
+    1. ``AGENTS.md`` managed block (``MANAGED_OPENCODE_BEGIN`` … ``MANAGED_OPENCODE_END``)
+       containing C3 usage instructions, CLAUDE.md content, and promoted rules.
+    2. ``.opencode/agents/c3-<name>.md`` — one file per agent defined in
+       ``.claude/agents/*.md``.
+    3. ``.opencode/agents/c3-skill-<name>.md`` — one file per skill defined in
+       ``.claude/skills/<name>/SKILL.md``.
+    """
+    actions: list[AdapterAction] = []
+    actions.extend(_write_opencode_agents_md(target_root, dry_run=dry_run))
+    actions.extend(_write_opencode_agents(target_root, dry_run=dry_run))
+    actions.extend(_write_opencode_skills(target_root, dry_run=dry_run))
+    return actions
+
+
 def _write_codex_adapter(target_root: Path, *, dry_run: bool) -> list[AdapterAction]:
     actions: list[AdapterAction] = []
     actions.extend(_write_managed_block(
@@ -299,6 +380,227 @@ mention the Claude Code `Skill` tool, read the matching file under
 """
 
 
+def _write_opencode_agents_md(target_root: Path, *, dry_run: bool) -> list[AdapterAction]:
+    """Write C3 adapter instructions into AGENTS.md for OpenCode."""
+    claude_root = target_root / ".claude"
+    rules_content = _collect_rules_for_opencode(claude_root)
+    claude_md = claude_root / "CLAUDE.md"
+    claude_md_content = claude_md.read_text(encoding="utf-8") if claude_md.exists() else ""
+    # CR L-03: sanitization is delegated entirely to _opencode_agents_section,
+    # which calls _sanitize_for_managed_block on both arguments.  Calling it
+    # here a second time would be redundant (the function is idempotent), but
+    # centralising the responsibility in _opencode_agents_section is cleaner.
+    section = _opencode_agents_section(rules_content, claude_md_content)
+    return _write_managed_block(
+        target_root / "AGENTS.md",
+        section,
+        MANAGED_OPENCODE_BEGIN,
+        MANAGED_OPENCODE_END,
+        dry_run=dry_run,
+    )
+
+
+def _collect_rules_for_opencode(claude_root: Path) -> str:
+    """Read ``.claude/rules/*.md`` files (top-level only; subdirectories are not walked).
+
+    Intentionally non-recursive: ``rules/promoted/`` contains a managed index
+    frame (``index.md``) that is nearly empty, and rglob-ing it would inject
+    noise into the OpenCode managed block.
+
+    SR-V-002: applies the same symlink guard used by ``_write_opencode_agents``
+    and ``_write_opencode_skills``; files that resolve outside ``rules_dir`` are
+    skipped silently.
+    """
+    rules_dir = claude_root / "rules"
+    if not rules_dir.is_dir():
+        return ""
+    rules_dir_resolved = rules_dir.resolve()
+    parts: list[str] = []
+    for f in sorted(rules_dir.glob("*.md")):
+        # SR-V-002: symlink guard — skip entries that resolve outside rules_dir.
+        try:
+            resolved = f.resolve(strict=True)
+        except OSError:
+            continue
+        if not resolved.is_relative_to(rules_dir_resolved):
+            continue
+        content = f.read_text(encoding="utf-8").strip()
+        if content:
+            parts.append(f"### {f.stem}\n\n{content}")
+    return "\n\n".join(parts)
+
+
+def _opencode_agents_section(rules: str, claude_md: str) -> str:
+    # NOTE: The @mention list below is intentionally static and lists only the
+    # user-facing entry-point agents.  Internal agents such as ``wt_*`` variants
+    # and ``project-setup`` are excluded because they are spawned programmatically
+    # by the parallel-agents skill and are not meant to be invoked directly by
+    # the user.  (CR M-01 / L-03: design-intent comment; no dynamic generation.)
+    section = """# C3 Adapter for OpenCode
+
+This repository uses Claude Code Conductor (C3). The canonical C3 workflow is
+kept under `.claude/`; OpenCode adapter files are generated from that source.
+
+## How to Use C3 with OpenCode
+
+- `@c3-interviewer` - Start a requirements interview
+- `@c3-architect` - Generate architecture design
+- `@c3-planner` - Create a task plan
+- `@c3-developer` - Implement code (TDD)
+- `@c3-tester` - Write and run tests
+- `@c3-code-reviewer` - Review code quality
+- `@c3-security-reviewer` - Security review
+- `@c3-doc-writer` - Generate documentation
+- `@c3-systematic-debugger` - Debug complex issues
+
+## Key Concepts
+
+1. C3 state (reports, memory, sessions) lives in `.claude/`
+2. Agents are invoked via `@mention` in OpenCode
+3. C3 reports are the handoff mechanism between agents
+4. User approval is required between phases
+
+When C3 instructions contain an `AskUserQuestion` JSON block, ask the user
+directly and preserve `multiSelect: true` as a multi-select question.
+
+When C3 instructions mention the Claude Code `Agent` tool, use OpenCode
+subagents via `@mention`. When they mention the `Skill` tool, read the
+matching `.claude/skills/<name>/SKILL.md` file.
+"""
+    # Sanitize embedded content to strip @-include directives and managed-block
+    # marker strings that could corrupt the OpenCode managed block boundary
+    # (SR-AI-001 / CR M-03 / CR-NEW-01).
+    safe_claude_md = _sanitize_for_managed_block(claude_md)
+    safe_rules = _sanitize_for_managed_block(rules)
+    if safe_claude_md.strip():
+        section += f"\n\n## C3 Behavior Rules\n\n{safe_claude_md.strip()}"
+    if safe_rules.strip():
+        section += f"\n\n## C3 Injected Rules\n\n{safe_rules}"
+    return section
+
+
+def _write_opencode_agents(target_root: Path, *, dry_run: bool) -> list[AdapterAction]:
+    """Convert .claude/agents/*.md to .opencode/agents/c3-*.md"""
+    source_root = target_root / ".claude" / "agents"
+    if not source_root.is_dir():
+        return []
+    actions: list[AdapterAction] = []
+    source_root_resolved = source_root.resolve()
+    for source in sorted(source_root.glob("*.md")):
+        # CR M-04 / SR-NEW: mirror the should_skip guard from _write_codex_agents.
+        # rel is relative to .claude/ (e.g. "agents/tdd-develop.md") to match
+        # the EXCLUDE_PATTERNS convention used by _write_codex_agents.
+        rel = source.relative_to(target_root / ".claude")
+        if should_skip(rel.as_posix()):
+            continue
+        # SR-V-002: symlink guard — skip sources that resolve outside source_root.
+        try:
+            resolved = source.resolve(strict=True)
+        except OSError:
+            continue
+        if not resolved.is_relative_to(source_root_resolved):
+            continue
+        name = source.stem
+        text = source.read_text(encoding="utf-8")
+        metadata, body = _split_frontmatter(text)
+        description = str(metadata.get("description") or _first_heading(body) or name)
+        agent_md = _opencode_agent_md(name, description, body)
+        dest = target_root / ".opencode" / "agents" / f"c3-{name}.md"
+        actions.extend(_write_file_if_changed(dest, agent_md, dry_run=dry_run))
+    return actions
+
+
+def _opencode_agent_md(name: str, description: str, body: str) -> str:
+    """Generate an OpenCode agent markdown file with YAML frontmatter."""
+    interactive = {"interviewer", "architect", "planner"}
+    mode = "all-purpose" if name in interactive else "subagent"
+    # Strip trailing whitespace from the combined description so that an empty
+    # ``description`` argument does not produce a trailing space on the line
+    # (CR L-01).  Pass the stripped value through _yaml_inline_scalar so that
+    # colons, double-quotes, and newlines are safely quoted (CR H-01 / SR-V-001).
+    full_desc = _yaml_inline_scalar(f"C3 {name} agent. {description}".strip())
+    return (
+        f"---\n"
+        f"name: c3-{name}\n"
+        f"mode: {mode}\n"
+        f"description: {full_desc}\n"
+        f"tools:\n"
+        f"  - bash\n  - read\n  - edit\n  - write\n  - websearch\n"
+        f"---\n\n"
+        f"# C3 Agent: {name}\n\n"
+        f"Generated from `.claude/agents/{name}.md`.\n\n"
+        f"## Adapter Notes\n\n"
+        f"- C3 state root: `.claude/`\n"
+        f"- Reports go to `.claude/reports/`\n"
+        f"- Session memory: `.claude/memory/`\n"
+        f"- When done, write your output report to the appropriate path\n\n"
+        f"## Original Agent Definition\n\n"
+        f"{body.strip()}\n"
+    )
+
+
+def _write_opencode_skills(target_root: Path, *, dry_run: bool) -> list[AdapterAction]:
+    """Convert .claude/skills/*/SKILL.md to .opencode/agents/c3-skill-*.md"""
+    source_root = target_root / ".claude" / "skills"
+    if not source_root.is_dir():
+        return []
+    actions: list[AdapterAction] = []
+    source_root_resolved = source_root.resolve()
+    for skill_dir in sorted(source_root.iterdir()):
+        if not skill_dir.is_dir():
+            continue
+        skill_file = skill_dir / "SKILL.md"
+        if not skill_file.exists():
+            continue
+        skill_name = skill_dir.name
+        # CR M-04 / SR-NEW: mirror should_skip guard from _write_codex_skills.
+        # rel is relative to .claude/ (e.g. "skills/worktree-tdd-workflow/SKILL.md").
+        rel = skill_file.relative_to(target_root / ".claude")
+        if should_skip(rel.as_posix()):
+            continue
+        # SR-V-002: symlink guard — skip files that resolve outside source_root.
+        try:
+            resolved = skill_file.resolve(strict=True)
+        except OSError:
+            continue
+        if not resolved.is_relative_to(source_root_resolved):
+            continue
+        text = skill_file.read_text(encoding="utf-8")
+        metadata, body = _split_frontmatter(text)
+        description = str(metadata.get("description") or _first_heading(body) or skill_name)
+        agent_md = _skill_to_opencode_agent_md(skill_name, description, body)
+        dest = target_root / ".opencode" / "agents" / f"c3-skill-{skill_name}.md"
+        actions.extend(_write_file_if_changed(dest, agent_md, dry_run=dry_run))
+    return actions
+
+
+def _skill_to_opencode_agent_md(skill_name: str, description: str, body: str) -> str:
+    """Convert a C3 SKILL.md to an OpenCode agent definition."""
+    # CR H-02 / L-06 / SR-V-001: use the shared YAML-safe scalar helper so that
+    # double-quotes or special characters in description do not break the
+    # frontmatter (previously used a raw double-quoted string literal).
+    full_desc = _yaml_inline_scalar(f"C3 skill: {description}")
+    return (
+        f"---\n"
+        f"name: c3-skill-{skill_name}\n"
+        f"mode: all-purpose\n"
+        f"description: {full_desc}\n"
+        f"tools:\n"
+        f"  - bash\n  - read\n  - edit\n  - write\n  - websearch\n"
+        f"---\n\n"
+        f"# C3 Skill: {skill_name}\n\n"
+        f"Generated from `.claude/skills/{skill_name}/SKILL.md`.\n\n"
+        f"## Adapter Notes\n\n"
+        f"- This skill is the OpenCode equivalent of the C3 `/{skill_name}` command\n"
+        f"- C3 state root: `.claude/`\n"
+        f"- When the original references `AskUserQuestion`, ask the user directly\n"
+        f"- When the original references the `Agent` tool, use `@mention`\n"
+        f"- When the original references the `Skill` tool, read `.claude/skills/<name>/SKILL.md`\n\n"
+        f"## Original Skill Definition\n\n"
+        f"{body.strip()}\n"
+    )
+
+
 def _convert_skill(text: str, skill_name: str) -> str:
     metadata, body = _split_frontmatter(text)
     metadata["name"] = metadata.get("name") or skill_name

{claude_code_conductor-2.29.4 → claude_code_conductor-2.30.0}/src/c3/cli_doctor.py

@@ -48,6 +48,8 @@ def handle(args: argparse.Namespace) -> int:
         findings.extend(_check_codex_adapter())
     if "cursor" in platforms:
         findings.extend(_check_cursor_adapter())
+    if "opencode" in platforms:
+        findings.extend(_check_opencode_adapter())
 
     exit_code = 0
     for status, label, detail in findings:
@@ -117,6 +119,25 @@ def _check_codex_adapter() -> list[tuple[str, str, str]]:
     return findings
 
 
+def _check_opencode_adapter() -> list[tuple[str, str, str]]:
+    root = claude_root_for(Path.cwd())
+    if root is None:
+        return [(_WARN, "opencode adapter", "skipped (.claude/ not found)")]
+    findings = []
+    agents_md = root / "AGENTS.md"
+    opencode_agents = root / ".opencode" / "agents"
+    findings.append(_file_or_warn("AGENTS.md", agents_md, "run `c3 init --platform opencode`"))
+    findings.append(
+        _dir_or_warn(".opencode/agents", opencode_agents, "run `c3 init --platform opencode`")
+    )
+    opencode = shutil.which("opencode")
+    if opencode is None:
+        findings.append((_WARN, "opencode binary", "not on PATH; install OpenCode CLI to use the adapter"))
+    else:
+        findings.append((_OK, "opencode binary", opencode))
+    return findings
+
+
 def _check_cursor_adapter() -> list[tuple[str, str, str]]:
     root = claude_root_for(Path.cwd())
     if root is None:

{claude_code_conductor-2.29.4 → claude_code_conductor-2.30.0}/src/c3/platforms.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-SUPPORTED_PLATFORMS = ("claude", "codex", "cursor")
+SUPPORTED_PLATFORMS = ("claude", "codex", "cursor", "opencode")
 PLATFORM_CHOICES = (*SUPPORTED_PLATFORMS, "all")