claude-code-conductor 2.3.0__tar.gz → 2.4.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (134) hide show
  1. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/CLAUDE.md +12 -0
  2. claude_code_conductor-2.4.0/.claude/docs/platform-adapters.md +167 -0
  3. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.gitignore +8 -0
  4. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/CHANGELOG.md +78 -0
  5. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/PKG-INFO +19 -6
  6. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/README.md +16 -3
  7. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/pyproject.toml +2 -2
  8. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/__init__.py +1 -1
  9. claude_code_conductor-2.4.0/src/c3/adapters.py +389 -0
  10. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/cli.py +2 -1
  11. claude_code_conductor-2.4.0/src/c3/cli_ask.py +60 -0
  12. claude_code_conductor-2.4.0/src/c3/cli_doctor.py +162 -0
  13. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/cli_init.py +28 -4
  14. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/cli_update.py +48 -20
  15. claude_code_conductor-2.4.0/src/c3/mcp_server.py +282 -0
  16. claude_code_conductor-2.4.0/src/c3/platforms.py +17 -0
  17. claude_code_conductor-2.4.0/src/c3/question.py +415 -0
  18. claude_code_conductor-2.4.0/tests/test_adapters.py +276 -0
  19. claude_code_conductor-2.4.0/tests/test_cli_ask.py +280 -0
  20. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_cli_init.py +85 -4
  21. claude_code_conductor-2.3.0/src/c3/cli_doctor.py +0 -99
  22. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/architect.md +0 -0
  23. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/code-reviewer.md +0 -0
  24. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/developer.md +0 -0
  25. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/doc-writer.md +0 -0
  26. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/interviewer.md +0 -0
  27. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/planner.md +0 -0
  28. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/project-setup.md +0 -0
  29. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/security-reviewer.md +0 -0
  30. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/systematic-debugger.md +0 -0
  31. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/tester.md +0 -0
  32. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/wt_developer.md +0 -0
  33. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/wt_systematic-debugger.md +0 -0
  34. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/agents/wt_tester.md +0 -0
  35. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/docs/settings.json.md +0 -0
  36. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/consolidate_memory.py +0 -0
  37. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/permission_handler.py +0 -0
  38. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/post_tool.py +0 -0
  39. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/pre_compact.py +0 -0
  40. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/pre_tool.py +0 -0
  41. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/record_review_decision.py +0 -0
  42. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/record_tier_outcome.py +0 -0
  43. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/restore_session.py +0 -0
  44. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/review_hint_inject.py +0 -0
  45. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/schema.sql +0 -0
  46. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/select_tier.py +0 -0
  47. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/session_start.py +0 -0
  48. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/session_stop.py +0 -0
  49. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/session_utils.py +0 -0
  50. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/statusline.py +0 -0
  51. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/stop.py +0 -0
  52. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/subagent_log.py +0 -0
  53. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/hooks/worktree_guard.py +0 -0
  54. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/memory/.gitkeep +0 -0
  55. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/permission_rules.json +0 -0
  56. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/rules/code-review-checklist.md +0 -0
  57. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/rules/promoted/index.md +0 -0
  58. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/rules/security-review-checklist.md +0 -0
  59. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/settings.json +0 -0
  60. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/code-review/SKILL.md +0 -0
  61. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/dev-workflow/SKILL.md +0 -0
  62. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/develop/SKILL.md +0 -0
  63. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/doc/SKILL.md +0 -0
  64. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/extract-lib/SKILL.md +0 -0
  65. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/init-session/SKILL.md +0 -0
  66. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/mcp-config/SKILL.md +0 -0
  67. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/parallel-agents/SKILL.md +0 -0
  68. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/pattern-status/SKILL.md +0 -0
  69. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/promote-pattern/SKILL.md +0 -0
  70. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/report-timestamp/SKILL.md +0 -0
  71. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/report-timestamp/scripts/get_timestamp.py +0 -0
  72. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/setup/SKILL.md +0 -0
  73. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/start/SKILL.md +0 -0
  74. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/skills/task-routing/SKILL.md +0 -0
  75. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/.claude/state/.gitkeep +0 -0
  76. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/LICENSE +0 -0
  77. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/hatch_build.py +0 -0
  78. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/__main__.py +0 -0
  79. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/_excludes.py +0 -0
  80. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/_terminal.py +0 -0
  81. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/cli_list.py +0 -0
  82. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/cli_plan.py +0 -0
  83. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/cli_tier.py +0 -0
  84. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/db.py +0 -0
  85. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/paths.py +0 -0
  86. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/src/c3/plan_validator.py +0 -0
  87. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/__init__.py +0 -0
  88. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/conftest.py +0 -0
  89. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/__init__.py +0 -0
  90. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_consolidate_memory.py +0 -0
  91. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_permission_handler.py +0 -0
  92. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_pip_reinstall_reminder.py +0 -0
  93. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_planner_check.py +0 -0
  94. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_post_tool.py +0 -0
  95. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_pre_tool.py +0 -0
  96. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_record_tier_outcome.py +0 -0
  97. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_restore_session.py +0 -0
  98. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_review_hint_inject.py +0 -0
  99. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_select_tier.py +0 -0
  100. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_select_tier_escalation.py +0 -0
  101. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_session_start.py +0 -0
  102. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_session_stop.py +0 -0
  103. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_session_utils.py +0 -0
  104. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_settings_local_absolute_paths.py +0 -0
  105. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_similarity_boost.py +0 -0
  106. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_statusline.py +0 -0
  107. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_statusline_template_sync.py +0 -0
  108. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_subagent_log.py +0 -0
  109. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_sync_check.py +0 -0
  110. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/hooks/test_template_guard.py +0 -0
  111. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/skills/__init__.py +0 -0
  112. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/skills/test_session_backlog_reconciliation.py +0 -0
  113. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/skills/test_start_skill_bugfix_flow.py +0 -0
  114. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/skills/test_start_skill_security_audit_phase.py +0 -0
  115. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/skills/test_task_routing_skill.py +0 -0
  116. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_cli_list.py +0 -0
  117. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_cli_plan.py +0 -0
  118. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_cli_tier.py +0 -0
  119. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_docstring_consistency.py +0 -0
  120. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_excludes.py +0 -0
  121. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_paths.py +0 -0
  122. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_plan_validator.py +0 -0
  123. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_pre_compact.py +0 -0
  124. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_pre_tool_hook.py +0 -0
  125. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_precompact_additional.py +0 -0
  126. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_precompact_toctou_fixes.py +0 -0
  127. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_session_utils_additional.py +0 -0
  128. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_statusline.py +0 -0
  129. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_stop_additional.py +0 -0
  130. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_stop_hook.py +0 -0
  131. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_stop_precompact_fixes.py +0 -0
  132. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_sync_template_stop.py +0 -0
  133. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_template_pre_tool_hook.py +0 -0
  134. {claude_code_conductor-2.3.0 → claude_code_conductor-2.4.0}/tests/test_worktree_guard.py +0 -0
@@ -50,6 +50,18 @@
50
50
  `.claude/docs/` は人間向けリファレンスのためエージェントは読まなくてよい。
51
51
  詳細は `.claude/docs/taxonomy.md` を参照。
52
52
 
53
+ ## Platform Compatibility
54
+
55
+ このファイルは Claude Code / Codex / Cursor から canonical source として読まれる。
56
+ 他プラットフォームでの動作差分は以下の通り:
57
+
58
+ - **`AskUserQuestion`** への参照は、Codex/Cursor では MCP tool `c3_ask_user_question` に読み替える(MCP elicitation 非対応時の fallback は `c3 ask --file <json>`)
59
+ - **`Agent` ツール** の参照は、Codex では `.codex/agents/<name>.toml` 経由のサブエージェント、Cursor では現行 runtime のサブエージェント機構(無い場合は同一 agent 内でフェーズ実行しレポート契約のみ維持)に読み替える
60
+ - **`Skill` ツール / `/<skill>`** の参照は、Codex では `.agents/skills/<name>/SKILL.md`、Cursor では `.claude/skills/<name>/SKILL.md` を直接読み込む(スラッシュコマンド自動展開は Claude Code 専用機能)
61
+ - **`isolation: worktree`** / **`permissionMode`** / **`tools` 制限** など agent フロントマターの一部キーは Claude Code 仕様。adapter 側では読み替え不能なものは無視される
62
+
63
+ レポート(`.claude/reports/`)・state(`.claude/state/`)・memory(`.claude/agent-memory/`)のファイル名と書き込み先は全プラットフォーム共通。adapter 生成物の詳細は `c3 init --platform codex|cursor` で出力される `AGENTS.md` / `.cursor/rules/c3-core.mdc` を参照。
64
+
53
65
  ---
54
66
 
55
67
  ## C3 Managed
@@ -0,0 +1,167 @@
1
+ # Platform Adapters
2
+
3
+ C3 は **Claude Code** を canonical platform として設計されているが、
4
+ `c3 init --platform` で Codex / Cursor 向けの adapter を生成し、同じ `.claude/`
5
+ ツリーを共通の source of truth として利用できる。
6
+
7
+ 本ドキュメントは:
8
+ - `c3 init --platform` の選択肢と生成物
9
+ - MCP server と `c3 ask` CLI fallback
10
+ - managed block の仕様と手動編集の取り扱い
11
+ - 動作差分のまとめ
12
+
13
+ を一箇所にまとめたリファレンス。実装は `src/c3/adapters.py` / `src/c3/mcp_server.py` /
14
+ `src/c3/cli_ask.py` / `src/c3/platforms.py` を参照。
15
+
16
+ ---
17
+
18
+ ## 1. `c3 init --platform` の選択肢
19
+
20
+ | 値 | 生成物 | 用途 |
21
+ |---|---|---|
22
+ | `claude` (デフォルト) | `.claude/` のみ | Claude Code ネイティブ |
23
+ | `codex` | `.claude/` + `AGENTS.md` + `.codex/` + `.agents/` | Codex CLI / 職場 Codex |
24
+ | `cursor` | `.claude/` + `.cursor/` | Cursor IDE |
25
+ | `all` | 上記すべて | マルチプラットフォーム共存 |
26
+
27
+ `c3 init --platform claude` 以外でも `.claude/` は canonical source として残り、
28
+ adapter は派生ファイルを生成するのみ(`.claude/` の中身を変更しない)。
29
+
30
+ `c3 update --platform <p>` で adapter を再生成できる。`.claude/` 側の skill / agent
31
+ を編集したら adapter も再生成して整合を取る。
32
+
33
+ ---
34
+
35
+ ## 2. 生成される具体的ファイル
36
+
37
+ ### `codex` 選択時
38
+
39
+ | パス | 内容 | 生成ロジック |
40
+ |---|---|---|
41
+ | `AGENTS.md` | プロジェクト直下。Codex に C3 workflow の存在と adapter を伝える | `_codex_agents_section` を managed block で挿入 |
42
+ | `.codex/config.toml` | Codex CLI の MCP 設定 | `[mcp_servers.c3]` セクションを managed block で挿入 |
43
+ | `.codex/agents/<name>.toml` | `.claude/agents/<name>.md` から生成した Codex subagent 定義 | `_codex_agent_toml` で TOML 化 |
44
+ | `.agents/skills/<name>/SKILL.md` | `.claude/skills/<name>/SKILL.md` を Codex 向けに変換コピー | `_convert_skill` で frontmatter 正規化 + adapter note 追加 |
45
+ | `.agents/skills/<name>/<その他>` | `.claude/skills/<name>/` 配下の非 `SKILL.md` ファイルをそのまま複製 | `_copy_file_if_changed` |
46
+
47
+ ### `cursor` 選択時
48
+
49
+ | パス | 内容 | 生成ロジック |
50
+ |---|---|---|
51
+ | `.cursor/rules/c3-core.mdc` | Cursor の rule。`alwaysApply: true` で C3 workflow を常時参照 | `_cursor_core_rule` の静的テキスト |
52
+ | `.cursor/mcp.json` | Cursor の MCP サーバー設定。`mcpServers.c3` のみ管理対象 | `_write_cursor_mcp` で既存 JSON にマージ |
53
+
54
+ ---
55
+
56
+ ## 3. MCP server (`c3.mcp_server`)
57
+
58
+ stdio MCP サーバー。Codex / Cursor から `.codex/config.toml` / `.cursor/mcp.json`
59
+ 経由で起動される。プロトコル: JSON-RPC 2.0 (`2025-11-25`)。
60
+
61
+ ### 提供ツール
62
+
63
+ | ツール名 | 用途 | 入力 |
64
+ |---|---|---|
65
+ | `c3_ask_user_question` | `AskUserQuestion` 互換の単一/複数選択。MCP elicitation を使用 | `payload`: `AskUserQuestion` の JSON |
66
+ | `c3_list_skills` | `.claude/skills/` 配下のスキル一覧を返す | なし |
67
+ | `c3_read_skill` | `.claude/skills/<name>/SKILL.md` を読み込む | `name`: skill 名 |
68
+
69
+ ### セキュリティ
70
+
71
+ - `c3_read_skill` は `.claude/skills/` 外への symlink を `resolved.parents` チェックで拒否
72
+ - パス区切りに `.` / `..` を含む name は弾く
73
+ - skill ファイル名は `SKILL.md` で固定(任意ファイル読み出しはできない)
74
+
75
+ ### 起動コマンド
76
+
77
+ ```bash
78
+ python -m c3.mcp_server
79
+ ```
80
+
81
+ `C3_PROJECT_ROOT` 環境変数でプロジェクトルートを指定可能(adapter 生成時に自動設定)。
82
+ ソースインストール時は `PYTHONPATH` も adapter が `<repo>/src` に設定する。
83
+
84
+ ---
85
+
86
+ ## 4. `c3 ask` CLI fallback
87
+
88
+ MCP elicitation が使えない環境(CI / 非対応 host)向けの fallback。
89
+
90
+ ```bash
91
+ # ファイルから AskUserQuestion JSON を読み、対話で回答
92
+ c3 ask --file question.json
93
+
94
+ # JSON を直接渡す
95
+ c3 ask --json '{"questions":[...]}'
96
+
97
+ # 非対話実行(CI 用)
98
+ c3 ask --file question.json --response "Plan,Review"
99
+ ```
100
+
101
+ 回答は JSON で stdout に出力されるため、シェルパイプで次のステップに渡せる。
102
+
103
+ ---
104
+
105
+ ## 5. managed block
106
+
107
+ adapter は **管理範囲を明示するマーカー** で囲んだブロックのみを書き換え、
108
+ ユーザーが追記した他の部分には触らない。
109
+
110
+ ### Markdown (`AGENTS.md`)
111
+
112
+ ```
113
+ <!-- BEGIN C3 CODEX ADAPTER -->
114
+ ... (adapter が管理する内容)
115
+ <!-- END C3 CODEX ADAPTER -->
116
+ ```
117
+
118
+ ### TOML (`.codex/config.toml`)
119
+
120
+ ```
121
+ # BEGIN C3 CODEX ADAPTER
122
+ [mcp_servers.c3]
123
+ ...
124
+ # END C3 CODEX ADAPTER
125
+ ```
126
+
127
+ ### JSON (`.cursor/mcp.json`)
128
+
129
+ managed block は使わず、`mcpServers.c3` キーだけを上書き。他のサーバー定義は保持。
130
+
131
+ ### 手動編集の取り扱い
132
+
133
+ - **managed block の外は自由に編集 OK**: adapter は触らない
134
+ - **managed block の中は再生成で上書き**: `c3 update --platform codex` で `.claude/` 側の変更が反映される
135
+ - **managed block を削除した場合**: 次回 adapter 生成時にファイル末尾に追加される
136
+ - **managed block を残したまま中身を書き換えた場合**: `c3 update --platform codex` で上書きされる
137
+ - **`[mcp_servers.c3]` を managed block の外で定義した場合**: 競合検出して `ValueError` を投げる(`adapters.py:_write_codex_config`)
138
+
139
+ ---
140
+
141
+ ## 6. 動作差分まとめ
142
+
143
+ | 機能 | Claude Code | Codex | Cursor |
144
+ |---|---|---|---|
145
+ | `AskUserQuestion` | ネイティブツール | MCP `c3_ask_user_question` / fallback `c3 ask` | 同左 |
146
+ | `Agent` ツール | ネイティブ subagent | `.codex/agents/<name>.toml` 経由の subagent | runtime に subagent 機構があれば使用、無ければ同一 agent 内でフェーズ実行 |
147
+ | `Skill` ツール / `/<skill>` | ネイティブ | `.agents/skills/<name>/SKILL.md` を読む | `.claude/skills/<name>/SKILL.md` を rule から指示 |
148
+ | `isolation: worktree` | サポート | 一部 Codex runtime で対応、不可時は同一 worktree 実行 | 反映されない |
149
+ | `permissionMode` | サポート | 概念なし(無視) | 概念なし(無視) |
150
+ | `tools` 制限 | サポート | Codex subagent のツール制限に部分対応 | rule テキスト内で補完 |
151
+ | `hooks` (lifecycle) | サポート | 非対応(無視) | 非対応(無視) |
152
+ | `memory` (`MEMORY.md` 注入) | サポート | `.claude/agent-memory/` を共通参照 | 同左 |
153
+ | パターン昇格 (`/promote-pattern`) | ネイティブ | `c3 init --platform codex` 後は `.agents/skills/promote-pattern/SKILL.md` を読んで実行 | rule から `.claude/skills/promote-pattern/SKILL.md` を指示 |
154
+ | レポート (`.claude/reports/`) | 共通 | 共通 | 共通 |
155
+ | state (`.claude/state/`) | 共通 | 共通 | 共通 |
156
+
157
+ レポート・state・memory のファイル名と書き込み先は全プラットフォーム共通。これにより
158
+ Claude Code / Codex / Cursor が同じプロジェクトを行き来しても workflow 状態が保たれる。
159
+
160
+ ---
161
+
162
+ ## 7. 既知の制限
163
+
164
+ - **`AskUserQuestion` の `multiSelect: true`**: MCP elicitation の仕様上、ホストが multi-select UI に対応していない場合は単一選択に degrade される。`c3 ask --file` の fallback は multi-select に対応
165
+ - **Cursor の subagent**: 2026-05 時点で Cursor は dedicated subagent 機構が限定的。adapter は「同一 agent でフェーズ実行・レポート契約を維持」を方針とする
166
+ - **Codex の `isolation: worktree`**: Codex 側の subagent runtime に依存。worktree 非対応の場合は無視される
167
+ - **改行コード**: adapter 生成ファイルは LF 改行で書き出す(`newline="\n"`)。`.gitattributes` で `eol=lf` を固定済み
@@ -52,6 +52,14 @@ site/
52
52
  # codex 対応調査メモ (個人作業ノート、配布・コミット対象外)
53
53
  .claude/docs/codex対応/
54
54
 
55
+ # Codex/Cursor adapter 生成物 (c3 init --platform で生成、配布物ではない)
56
+ # wheel 同梱は src/c3/_template/.claude/ 配下のみで構造的に除外されるが、
57
+ # 配布元リポジトリで c3 init --platform を試した場合の commit 混入を防ぐ。
58
+ /AGENTS.md
59
+ /.codex/
60
+ /.cursor/
61
+ /.agents/
62
+
55
63
  # C3 distributor-only (配布元固有の開発支援、配布されない)
56
64
  .dev/
57
65
  /CLAUDE.md
@@ -1,5 +1,83 @@
1
1
  # Changelog
2
2
 
3
+ ## [2.4.0] - 2026-05-12
4
+
5
+ ### 概要
6
+
7
+ Codex / Cursor adapter 追加(v2.3.0 系列)の整合性監査の結果見つかった問題を一括修正。MCP server の path traversal を symlink 経由まで防御し、adapter 内部関数のユニットテストを 22 ケース新設。Claude Code 専用機能の Codex/Cursor 読み替えを `taxonomy.md` と新規 `platform-adapters.md` で明示し、CRLF/LF の取り扱いを `.gitattributes` で固定化した。
8
+
9
+ ### 変更(セキュリティ強化)
10
+
11
+ #### MCP `_read_skill` の path traversal 防御強化 (M2)
12
+
13
+ `src/c3/mcp_server.py:_read_skill` を以下のように変更:
14
+
15
+ - `.` / `..` の文字列マッチに加え、`Path.resolve(strict=True)` で symlink を解決
16
+ - 解決後のパスが `.claude/skills/` 配下にあるかを `skills_root in resolved.parents` で検証
17
+ - 範囲外の場合は `None` を返す(エラー出さずサイレントに拒否)
18
+
19
+ これにより悪意ある symlink を `.claude/skills/<name>/SKILL.md` として配置しても、project_root 外のファイルが読まれなくなる。脅威モデル: 悪意あるリポジトリを clone した利用者を巻き込むシナリオ。
20
+
21
+ ### 変更(ドキュメント / 整合性)
22
+
23
+ #### Codex / Cursor 動作差分の明文化 (H3, M3, M4)
24
+
25
+ 3 つのドキュメントを更新:
26
+
27
+ - **`.claude/CLAUDE.md`**: `Platform Compatibility` セクション追加。`AskUserQuestion` / `Agent` / `Skill` / agent フロントマターの Codex/Cursor 読み替え方針を整理
28
+ - **`.claude/docs/taxonomy.md`**: agents セクション末尾に「Codex / Cursor での扱い」表を追加。`permissionMode` / `isolation` / `hooks` 等の Claude Code 専用キーの取り扱いを記述。memory スコープ表に運用ルール(配布除外・書き込みタイミング・手動編集・削除)を追加 (L3)
29
+ - **`.claude/docs/platform-adapters.md`** (新規): `c3 init --platform` の選択肢、生成物、MCP server (`c3_ask_user_question` / `c3_list_skills` / `c3_read_skill`)、`c3 ask` CLI fallback、managed block の仕様、動作差分マトリックスを 1 ファイルでまとめた利用先向け技術文書
30
+
31
+ #### README に PO 撤去履歴を明示 (L4)
32
+
33
+ `並列実行 (parallel-agents skill)` セクションに v2.0.0 で PO (Parallel Orchestra) 完全撤去された旨を追記。利用先で「PO」「外部プロセス」という単語が CHANGELOG に登場する理由を新規ユーザーが追跡できるようにした。
34
+
35
+ ### 変更(テスト追加)
36
+
37
+ #### `tests/test_adapters.py` 新設 (M1, L1)
38
+
39
+ `src/c3/adapters.py` の内部関数と MCP `_read_skill` をカバーする 23 ケース(うち 1 ケースは Windows で skip)を追加:
40
+
41
+ - `_toml_escape` / `_toml_multiline_escape` のエッジケース(backslash, quote, triple quote, 改行保持)
42
+ - `_convert_skill` の frontmatter あり/なし/heading なしの分岐
43
+ - `_codex_agent_toml` の特殊文字・改行保持
44
+ - `_replace_managed_block` の単一/複数 block ケース(`count=1` 契約を回帰防止)
45
+ - `_write_cursor_mcp` の merge / 新規作成 / 不正 JSON 拒否 / 非 object 拒否
46
+ - `scaffold_adapters` の `.claude/` 不在エラー / 冪等性
47
+ - MCP `_read_skill` の正常系 / `..` 拒否 / 空文字拒否 / 不在 / symlink 経由のアクセス拒否 (POSIX 限定)
48
+
49
+ ### 変更(環境整理)
50
+
51
+ #### `.gitignore` に adapter 生成物追加 (H2)
52
+
53
+ `c3 init --platform codex|cursor|all` で生成される `/AGENTS.md` / `/.codex/` / `/.cursor/` / `/.agents/` を配布元リポジトリでの git commit 混入から保護。wheel 同梱は `src/c3/_template/.claude/` 配下に限定されるため構造的に wheel には入らないが、開発者が adapter を試生成した時の事故防止のため明示除外。
54
+
55
+ #### `.gitattributes` 拡張 (M5)
56
+
57
+ `*.toml` / `*.mdc` を `text eol=lf` に。さらに `AGENTS.md` / `.codex/**/*` / `.cursor/**/*` も `eol=lf` で固定。Windows の `core.autocrlf=true` 環境でも adapter ファイルが CRLF 化されず、`_write_file_if_changed` の完全一致比較が安定する。
58
+
59
+ #### `.claude/settings.local.json` の PO 遺物削除 (H1)
60
+
61
+ `Bash(c3 po *)` と `python -m pytest tests/parallel_orchestra/...` の許可ルールを削除。`c3 po` コマンドと parallel_orchestra テストは v2.0.0 で撤去済みのため、これらルールは空回りしていた。
62
+
63
+ ### 削除
64
+
65
+ なし(破壊的変更なし)。
66
+
67
+ ### 互換性
68
+
69
+ - v2.3.x からの後方互換: **完全互換**(API 変更なし、振る舞い変更なし、削除なし)
70
+ - adapter 生成ファイル: 改行コードが CRLF だった環境では LF に正規化される。`git diff` 上で改行差が出るが内容差はない
71
+ - セキュリティ修正: MCP `_read_skill` の戻り値挙動が **拒否時に `None`** で変わらず。symlink を悪用していたケース(通常用途では存在しない)のみ拒否される
72
+
73
+ ### 検証
74
+
75
+ - 全テスト: 613 passed / 3 skipped (Windows 環境)
76
+ - wheel build: `claude_code_conductor-2.4.0-py3-none-any.whl` (81 entries) — adapter 生成物 (`.codex/` / `.cursor/` / `.agents/` / `AGENTS.md`) の混入なし、機密ファイル混入なし、新規 `platform-adapters.md` は配布対象に含まれる
77
+ - `c3 doctor`: 全項目 OK
78
+
79
+ ---
80
+
3
81
  ## [2.3.0] - 2026-05-12
4
82
 
5
83
  ### 概要
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: claude-code-conductor
3
- Version: 2.3.0
4
- Summary: Multi-agent orchestration framework for Claude Code (C3)
3
+ Version: 2.4.0
4
+ Summary: Multi-agent orchestration framework for Claude Code with Codex/Cursor adapters (C3)
5
5
  Project-URL: Homepage, https://github.com/satoh-y-0323/claude-code-conductor
6
6
  Project-URL: Repository, https://github.com/satoh-y-0323/claude-code-conductor
7
7
  Author: satoh-y-0323
@@ -27,7 +27,7 @@ License: MIT License
27
27
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
28
28
  SOFTWARE.
29
29
  License-File: LICENSE
30
- Keywords: agents,claude,claude-code,orchestration,tdd
30
+ Keywords: agents,claude,claude-code,codex,cursor,orchestration,tdd
31
31
  Classifier: Development Status :: 3 - Alpha
32
32
  Classifier: Intended Audience :: Developers
33
33
  Classifier: License :: OSI Approved :: MIT License
@@ -186,9 +186,11 @@ C3 のスラッシュコマンドはすべてスキル(`skills/{name}/SKILL.md
186
186
  | コマンド | 役割 |
187
187
  |---|---|
188
188
  | `c3 init` | 利用先プロジェクトに `.claude/` を展開する |
189
+ | `c3 init --platform codex|cursor|all` | `.claude/` を canonical source にしたまま Codex/Cursor adapter を追加 |
189
190
  | `c3 update` | `.claude/` をパッケージ最新版へ更新する(個人ファイルはスキップ) |
190
191
  | `c3 list-agents` / `list-skills` | 設置済みアセットを一覧表示 |
191
- | `c3 doctor` | 環境診断(`.claude/`・settings.json・claude バイナリ) |
192
+ | `c3 doctor` | 環境診断(`.claude/`・settings.json・claude バイナリ・adapter 生成物) |
193
+ | `c3 ask` | Claude Code 以外で `AskUserQuestion` 互換の単一選択・複数選択を実行 |
192
194
  | `c3 plan validate <plan-report>` | plan-report の YAML フロントマターと agent 存在を検証 |
193
195
  | `c3 plan waves <plan-report>` | plan-report の wave 分解結果を JSON で出力 |
194
196
 
@@ -250,6 +252,15 @@ c3 init
250
252
 
251
253
  `c3 init` がパッケージに同梱された `.claude/` テンプレートをカレントディレクトリへコピーします。後日テンプレート側を更新したい場合は `c3 update` で差分のみ反映できます(`reports/` や `memory/sessions/` 等の個人ファイルは保持されます)。
252
254
 
255
+ Codex/Cursor でも同じ C3 workflow を使う場合は、`.claude/` を動かさず adapter を追加します。
256
+
257
+ ```bash
258
+ c3 init --platform codex # AGENTS.md / .agents/skills / .codex を生成
259
+ c3 init --platform cursor # .cursor/rules / .cursor/mcp.json を生成
260
+ ```
261
+
262
+ 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` で読み替えます。
263
+
253
264
  **3. プロジェクトを Claude Code で開き、初期設定を行う**
254
265
 
255
266
  ```
@@ -342,7 +353,9 @@ Copy-Item -Recurse claude-code-conductor\.claude your-project\
342
353
 
343
354
  ## 並列実行 (parallel-agents skill)
344
355
 
345
- 計画フェーズで生成した plan-report を YAML フロントマター付きマニフェストとして読み込み、独立タスクを親 Claude の Agent ツール並列起動 + 公式 `isolation: "worktree"` で並列実行できます(v2.0.0 以降は外部プロセス不要)。
356
+ 計画フェーズで生成した plan-report を YAML フロントマター付きマニフェストとして読み込み、独立タスクを親 Claude の Agent ツール並列起動 + 公式 `isolation: "worktree"` で並列実行できます。
357
+
358
+ > **アーキテクチャ移行履歴:** v1.x までは外部プロセス制御の **PO (Parallel Orchestra)** が並列実行を担っていましたが、v2.0.0 で完全撤去されました。現在は Claude Code 公式の subagent 並列起動機能に統一されており、追加プロセス・追加デーモン・追加スキーマは不要です。
346
359
 
347
360
  要件は Python ≥ 3.10、PATH に `claude` バイナリ、PyYAML(C3 の依存として自動インストール)。
348
361
 
@@ -352,7 +365,7 @@ Copy-Item -Recurse claude-code-conductor\.claude your-project\
352
365
  2. `/develop` を起動 → **D-0** で plan-report のフロントマターを自動検出し `parallel-agents` skill へ切り替わる
353
366
  3. C3 が `c3 plan validate` でマニフェスト妥当性を検証、wave ごとにユーザー承認を取りながら Agent ツールで並列実行します
354
367
 
355
- TDD を伴う機能実装は、planner が「test- → impl- → confirm-」の 3 タスクペアに分解し、各 wave 内で独立機能間で並列起動されます(v2.1.0+、旧 `tdd-develop` agent はこのリリースで廃止)。
368
+ TDD を伴う機能実装は、planner が「test- → impl- → confirm-」の 3 タスクペアに分解し、各 wave 内で独立機能間で並列起動されます。並列実行時は worktree 専用の `wt_tester` / `wt_developer` / `wt_systematic-debugger` agent が使用され、レポートは `task_id` ベースのファイル名で出力されます。
356
369
 
357
370
  ---
358
371
 
@@ -143,9 +143,11 @@ C3 のスラッシュコマンドはすべてスキル(`skills/{name}/SKILL.md
143
143
  | コマンド | 役割 |
144
144
  |---|---|
145
145
  | `c3 init` | 利用先プロジェクトに `.claude/` を展開する |
146
+ | `c3 init --platform codex|cursor|all` | `.claude/` を canonical source にしたまま Codex/Cursor adapter を追加 |
146
147
  | `c3 update` | `.claude/` をパッケージ最新版へ更新する(個人ファイルはスキップ) |
147
148
  | `c3 list-agents` / `list-skills` | 設置済みアセットを一覧表示 |
148
- | `c3 doctor` | 環境診断(`.claude/`・settings.json・claude バイナリ) |
149
+ | `c3 doctor` | 環境診断(`.claude/`・settings.json・claude バイナリ・adapter 生成物) |
150
+ | `c3 ask` | Claude Code 以外で `AskUserQuestion` 互換の単一選択・複数選択を実行 |
149
151
  | `c3 plan validate <plan-report>` | plan-report の YAML フロントマターと agent 存在を検証 |
150
152
  | `c3 plan waves <plan-report>` | plan-report の wave 分解結果を JSON で出力 |
151
153
 
@@ -207,6 +209,15 @@ c3 init
207
209
 
208
210
  `c3 init` がパッケージに同梱された `.claude/` テンプレートをカレントディレクトリへコピーします。後日テンプレート側を更新したい場合は `c3 update` で差分のみ反映できます(`reports/` や `memory/sessions/` 等の個人ファイルは保持されます)。
209
211
 
212
+ Codex/Cursor でも同じ C3 workflow を使う場合は、`.claude/` を動かさず adapter を追加します。
213
+
214
+ ```bash
215
+ c3 init --platform codex # AGENTS.md / .agents/skills / .codex を生成
216
+ c3 init --platform cursor # .cursor/rules / .cursor/mcp.json を生成
217
+ ```
218
+
219
+ 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` で読み替えます。
220
+
210
221
  **3. プロジェクトを Claude Code で開き、初期設定を行う**
211
222
 
212
223
  ```
@@ -299,7 +310,9 @@ Copy-Item -Recurse claude-code-conductor\.claude your-project\
299
310
 
300
311
  ## 並列実行 (parallel-agents skill)
301
312
 
302
- 計画フェーズで生成した plan-report を YAML フロントマター付きマニフェストとして読み込み、独立タスクを親 Claude の Agent ツール並列起動 + 公式 `isolation: "worktree"` で並列実行できます(v2.0.0 以降は外部プロセス不要)。
313
+ 計画フェーズで生成した plan-report を YAML フロントマター付きマニフェストとして読み込み、独立タスクを親 Claude の Agent ツール並列起動 + 公式 `isolation: "worktree"` で並列実行できます。
314
+
315
+ > **アーキテクチャ移行履歴:** v1.x までは外部プロセス制御の **PO (Parallel Orchestra)** が並列実行を担っていましたが、v2.0.0 で完全撤去されました。現在は Claude Code 公式の subagent 並列起動機能に統一されており、追加プロセス・追加デーモン・追加スキーマは不要です。
303
316
 
304
317
  要件は Python ≥ 3.10、PATH に `claude` バイナリ、PyYAML(C3 の依存として自動インストール)。
305
318
 
@@ -309,7 +322,7 @@ Copy-Item -Recurse claude-code-conductor\.claude your-project\
309
322
  2. `/develop` を起動 → **D-0** で plan-report のフロントマターを自動検出し `parallel-agents` skill へ切り替わる
310
323
  3. C3 が `c3 plan validate` でマニフェスト妥当性を検証、wave ごとにユーザー承認を取りながら Agent ツールで並列実行します
311
324
 
312
- TDD を伴う機能実装は、planner が「test- → impl- → confirm-」の 3 タスクペアに分解し、各 wave 内で独立機能間で並列起動されます(v2.1.0+、旧 `tdd-develop` agent はこのリリースで廃止)。
325
+ TDD を伴う機能実装は、planner が「test- → impl- → confirm-」の 3 タスクペアに分解し、各 wave 内で独立機能間で並列起動されます。並列実行時は worktree 専用の `wt_tester` / `wt_developer` / `wt_systematic-debugger` agent が使用され、レポートは `task_id` ベースのファイル名で出力されます。
313
326
 
314
327
  ---
315
328
 
@@ -5,14 +5,14 @@ build-backend = "hatchling.build"
5
5
  [project]
6
6
  name = "claude-code-conductor"
7
7
  dynamic = ["version"]
8
- description = "Multi-agent orchestration framework for Claude Code (C3)"
8
+ description = "Multi-agent orchestration framework for Claude Code with Codex/Cursor adapters (C3)"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
11
11
  license = { file = "LICENSE" }
12
12
  authors = [
13
13
  { name = "satoh-y-0323" }
14
14
  ]
15
- keywords = ["claude", "claude-code", "agents", "orchestration", "tdd"]
15
+ keywords = ["claude", "claude-code", "codex", "cursor", "agents", "orchestration", "tdd"]
16
16
  classifiers = [
17
17
  "Development Status :: 3 - Alpha",
18
18
  "Intended Audience :: Developers",
@@ -1,3 +1,3 @@
1
1
  """Claude Code Conductor (C3) - multi-agent orchestration framework for Claude Code."""
2
2
 
3
- __version__ = "2.3.0"
3
+ __version__ = "2.4.0"