cowork-flow 0.0.19 → 0.0.21

package/README.md

@@ -23,8 +23,19 @@ cowork-flow 是一个用于新项目初始化协作流程的模板仓库。它
 ├── README.md
 └── template/
     ├── AGENTS.md
+    ├── CLAUDE.md
     ├── .codex/
     │   └── agents/
+    ├── .claude/
+    │   ├── settings.json
+    │   ├── agents/
+    │   ├── skills/
+    │   ├── commands/
+    │   └── hooks/
+    ├── .opencode/
+    │   ├── agents/
+    │   ├── commands/
+    │   └── plugins/
     ├── .agent/
     │   └── skills/
     └── .cowork-flow/
@@ -47,10 +58,16 @@ cowork-flow 是一个用于新项目初始化协作流程的模板仓库。它
 本地技能入口，覆盖 start、before-dev、brainstorming、writing-plans、check、finish-work、continue、meta、python-design、update-spec 和 break-loop 等协作动作。这里的 skill 应保持通用，不承载某个业务项目的一次性细节。
 
 `template/.codex/agents/`
-固定角色 agent 定义，包含 `cowork-research`、`cowork-implement` 和 `cowork-check`。主会话负责计划与收口，并用 Codex `spawn_agent` 派发固定 agent；派发必须使用 `fork_turns="none"`，提示词首行使用 `Active task: <task-dir>`。
+固定角色 agent 定义，包含 `cowork-research`、`cowork-implement` 和 `cowork-check`，以及对 Codex 默认 `worker`、`default`、`explorer` 的项目级防漂移约束。主会话负责计划与收口，并通过 host adapter 派发固定 agent；正式派发必须先创建 runtime context，再把 `cowork_runtime_context_id` 和 `cowork_host_context_key` 传给子代理。
 
 `template/.codex/config.toml`、`template/.codex/hooks.json`、`template/.codex/hooks/`
-Codex 项目级配置与每轮上下文注入入口。hook 会读取当前 session task、`.cowork-flow/workflow.md` 中的 `workflow-state` 片段和 `codex.dispatch_mode`，把流程状态注入到当前轮对话。
+Codex 项目级配置与每轮上下文注入入口。hook 会先用共享 entry classifier 判定当前输入，再读取当前 session task、`.cowork-flow/spec/workflow-state-templates.md` 中的 `workflow-state` 片段和 `codex.dispatch_mode`，把流程状态注入到当前轮对话。注入的 `codex-dispatch-mode` 只是主会话调度提示，不代表当前线程身份。
+
+`template/CLAUDE.md`、`template/.claude/settings.json`、`template/.claude/agents/`、`template/.claude/skills/`、`template/.claude/commands/`、`template/.claude/hooks/`
+Claude Code 项目级记忆、hook、固定 agent、skills 和 slash command。`CLAUDE.md` 显式导入 `AGENTS.md`。`.claude/settings.json` 注册 `UserPromptSubmit` 和 `SessionStart` hook，注入当前 workflow state 与 contract digest。固定 agent 通过 `.cowork-flow/run subagent init` 生成 runtime context，并在 prompt、env 或 metadata transport 中传递 `cowork_runtime_context_id`；hook 绑定成功后才进入叶子执行，绑定失败则 fail closed，避免被项目 bootstrap 或无任务首屏上下文拉偏。Claude Code 不自动加载 `.agent/skills/`，所以项目技能要放进 `.claude/skills/`。
+
+`template/.opencode/agents/`、`template/.opencode/commands/`、`template/.opencode/plugins/`
+OpenCode 项目级固定 agent、slash command 和系统上下文注入插件。插件会读取 `.cowork-flow/spec/registry.json`，注入短 contract digest。
 
 `template/.cowork-flow/`
 工作流目录，包含流程说明、任务状态、开发者工作区、项目规范、行为变更规格、实现计划和辅助脚本。`.cowork-flow/config.yaml` 只承载真实接线的 session/journal, Codex hint, and task lifecycle hook settings。
@@ -69,20 +86,20 @@ Codex 项目级配置与每轮上下文注入入口。hook 会读取当前 sessi
 使用 CLI 把模板内容安装到目标项目根目录：
 
 ```bash
-npx cowork-flow init ./my-project
+npx cowork-flow init ./my-project --platform codex
 ```
 
-`init` 会显式要求开发者身份。交互式终端会提示输入；脚本或 CI 请传入：
+`init` 会显式要求平台和开发者身份。平台可选 `codex`、`opencode`、`claude-code`、`all`，其中 `both` 仍作为兼容别名表示 `codex,opencode`。交互式终端会提示输入；脚本或 CI 请传入：
 
 ```bash
-npx cowork-flow init ./my-project --developer <your-name>
+npx cowork-flow init ./my-project --platform codex --developer <your-name>
 ```
 
 也可以先全局安装：
 
 ```bash
 npm install -g cowork-flow
-cowork-flow init ./my-project --developer <your-name>
+cowork-flow init ./my-project --platform codex --developer <your-name>
 ```
 
 初始化后优先完成这些配置：
@@ -104,27 +121,27 @@ npx cowork-flow --help
 初始化到新项目：
 
 ```bash
-cowork-flow init ./my-project
+cowork-flow init ./my-project --platform codex
 ```
 
-`init` 会直接复制模板中的 `.agent/skills/`、`.codex/` 和 `.cowork-flow/`，并初始化 `.cowork-flow/.developer` 与 `.cowork-flow/workspace/<developer>/`。交互式终端会提示输入开发者名称；非交互式环境必须传入 `--developer <name>`。`init` 不会复制额外技能包。
+`init` 会直接复制模板中的通用 `.cowork-flow/`，并按 `--platform` 只复制对应 host 资产：`codex` 复制 `.codex/`、`.agent/skills/` 与 `.cowork-flow/adapters/codex/`，`opencode` 复制 `.opencode/`、`.agent/skills/` 与 `.cowork-flow/adapters/opencode/`，`claude-code` 复制 `CLAUDE.md`、`.claude/`（含 `.claude/settings.json`、`.claude/hooks/`、`.claude/skills/`）与 `.cowork-flow/adapters/claude-code/`，不复制 `.agent/skills/`。`all` 或 `--platform codex,opencode,claude-code` 同时复制三者和 `.agent/skills/`。`both` 保持兼容，只复制 Codex 和 OpenCode。它还会初始化 `.cowork-flow/.developer` 与 `.cowork-flow/workspace/<developer>/`。交互式终端会先显示 checkbox 多选界面选择平台，再提示开发者名称；非交互式环境必须传入 `--platform <codex|opencode|claude-code|all>` 与 `--developer <name>`。`init` 不会复制额外技能包。
 
 初始化到当前项目：
 
 ```bash
-cowork-flow init .
+cowork-flow init . --platform opencode
 ```
 
 默认不会覆盖已有文件。需要预览时使用：
 
 ```bash
-cowork-flow init ./my-project --dry-run
+cowork-flow init ./my-project --platform all --dry-run
 ```
 
 需要明确覆盖已有文件时使用：
 
 ```bash
-cowork-flow init ./my-project --force --developer <your-name>
+cowork-flow init ./my-project --platform codex --force --developer <your-name>
 ```
 
 `--force` 不会静默覆盖既有 `.cowork-flow/.developer`；如需重设身份，请先显式处理旧身份文件。
@@ -142,7 +159,7 @@ cowork-flow sync .
 cowork-flow sync . --dry-run
 ```
 
-`sync` 默认刷新 `.agent/skills/`、`.cowork-flow/scripts/` 和 `AGENTS.md` 中的 `<!-- COWORK-FLOW:START --> ... <!-- COWORK-FLOW:END -->` 托管块，保留 `AGENTS.md` 托管块之外的项目自定义内容。`.cowork-flow/config.yaml`、`.cowork-flow/workflow.md`、`.cowork-flow/spec/`、任务、计划、变更和 workspace 记录默认受保护。只有明确传入 `--force` 时才整文件覆盖保护文件。
+`sync` 会自动识别目标项目已安装的 host 目录：只有 `.codex/` 时只同步 Codex 资产，只有 `.opencode/` 时只同步 OpenCode 资产，两者都有时同步两者；对应 `.cowork-flow/adapters/<host>/` 也按识别出的平台同步。检测到 Codex 或 OpenCode 时会刷新 `.agent/skills/`；Claude Code-only 项目只刷新 `.claude/settings.json`、`.claude/hooks/`、`.claude/skills/`，不会创建 `.agent/skills/`。通用部分默认刷新 `.cowork-flow/scripts/`、`.cowork-flow/spec/workflow-state-templates.md`，以及 `AGENTS.md` 和 `CLAUDE.md` 中的 `<!-- COWORK-FLOW:START --> ... <!-- COWORK-FLOW:END -->` 托管块，保留托管块之外的项目自定义内容。`.cowork-flow/config.yaml`、`.cowork-flow/workflow.md`、除 `workflow-state-templates.md` 外的 `.cowork-flow/spec/`、任务、计划、变更和 workspace 记录默认受保护。只有明确传入 `--force` 时才整文件覆盖保护文件。
 
 ## 常用入口
 
@@ -169,7 +186,9 @@ cowork-flow sync . --dry-run
 
 ```bash
 ./.cowork-flow/run get-context
+./.cowork-flow/run project-context refresh
 ./.cowork-flow/run task list
+./.cowork-flow/run task next
 ```
 
 创建并验证行为变更：
@@ -183,24 +202,50 @@ cowork-flow sync . --dry-run
 
 ```bash
 ./.cowork-flow/run task create "<title>" --slug <task-name>
+./.cowork-flow/run task next
 ./.cowork-flow/run task start <task-dir>
 ```
 
+`task next` is read-only. It reports the active task, status, blockers, and the
+next safe command before the main session starts work, dispatches fixed agents,
+checks, archives, or records the session.
+
+`project-context refresh` 会创建或刷新 `.cowork-flow/project-context.md`。生成块由
+本地项目文件确定，`Manual Notes` 区保留人工补充；该文件是项目索引，不替代
+`AGENTS.md`、`.cowork-flow/workflow.md` 或 `.cowork-flow/spec/`。
+
+L2 任务的 readiness gate 会在 `task start` 前阻塞缺失的 proposal/spec/design、
+计划、任务链接、边界、假设、验收标准或 verification commands；同一 blocker
+会出现在 `task next` 输出中。
+
+任务状态由阶段命令推进，`task next` 只读取状态：
+
+| 阶段 | 命令 | `task.json.status` |
+| --- | --- | --- |
+| 创建/计划 | `task create` | `planning` |
+| 开始执行 | `task start <task-dir>` | `in_progress` |
+| 进入检查 | `task review [task-dir]` | `review` |
+| 检查完成 | `task complete [task-dir]` | `completed` |
+| 清会话指针 | `task finish` | 不改变状态 |
+
 执行 plan 时使用固定 cowork agents：
 
 主会话负责创建/启动任务、维护计划与收口验证；可并行的实现或检查工作通过 Codex subagent 交给固定角色 agent。
 
-```python
-spawn_agent(
-    agent_type="cowork-implement",
-    fork_turns="none",
-    message="Active task: <task-dir>\n\n<assignment>",
-)
+```text
+./.cowork-flow/run subagent init --role implement --agent-type cowork-implement --execution-task-dir <task-dir> --title "<title>"
+```
+
+将命令返回的 prompt transport 放入子代理 prompt：
+
+```text
+cowork_runtime_context_id: <runtime_context_id>
+cowork_host_context_key: <host_context_key>
 ```
 
-默认角色为 `cowork-research`、`cowork-implement`、`cowork-check`，任务上下文由 agent 根据 active task 自行加载。主会话必须用 `wait_agent` 等待结果，验收输出，再用 `list_agents` / `close_agent` 收口。
+子代理首步执行 `./.cowork-flow/run subagent bind <runtime_context_id> <host_context_key>`；主会话验收前必须确认 runtime context 中 `status=bound` 且 `bound_context_key` 匹配。默认角色为 `cowork-research`、`cowork-implement`、`cowork-check`，任务上下文来自已绑定 runtime context，而不是 prompt 形状。
 
-Codex hook 启用后，每轮会自动注入 `<workflow-state>`，其中包含当前任务、状态来源和下一步流程提示。hook 不替代主会话验收；它只负责把 task 状态和 workflow gate 放进上下文。
+Codex hook 启用后，每轮会自动注入 `<workflow-state>`，其中包含入口分类、当前任务、状态来源和下一步流程提示。状态文本来自 `.cowork-flow/spec/workflow-state-templates.md`；`workflow.md` 只描述流程，不内联状态片段。hook 不替代主会话验收；它只负责把 task 状态和 workflow gate 放进上下文。
 
 记录 session：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "CLI for installing and maintaining cowork-flow collaboration templates.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -1,4 +1,5 @@
 import { stdin as input, stdout as output } from 'node:process';
+import { emitKeypressEvents } from 'node:readline';
 import { createInterface } from 'node:readline/promises';
 
 import { runInit } from './commands/init.js';
@@ -9,7 +10,7 @@ import { readPackageInfo } from './lib/package-info.js';
 const HELP = `cowork-flow
 
 Usage:
-  cowork-flow init [target] [--developer <name>] [--dry-run] [--force]
+  cowork-flow init [target] --platform <codex|opencode|claude-code|all> [--developer <name>] [--dry-run] [--force]
   cowork-flow update
   cowork-flow sync [target] [--dry-run] [--force]
   cowork-flow --version
@@ -39,9 +40,115 @@ async function defaultPrompt(message) {
   }
 }
 
+async function defaultSelectPlatforms({ message, choices, defaultSelected = [] }) {
+  if (!input.isTTY || !output.isTTY || typeof input.setRawMode !== 'function') {
+    return null;
+  }
+
+  const selected = new Set(defaultSelected);
+  let activeIndex = 0;
+  let search = '';
+  let renderedLines = 0;
+
+  const filteredChoices = () => {
+    const term = search.toLowerCase();
+    return choices.filter((choice) => choice.label.toLowerCase().includes(term));
+  };
+
+  const render = () => {
+    const visibleChoices = filteredChoices();
+    if (activeIndex >= visibleChoices.length) {
+      activeIndex = Math.max(0, visibleChoices.length - 1);
+    }
+
+    if (renderedLines > 0) {
+      output.write(`\x1b[${renderedLines}A\x1b[0J`);
+    }
+
+    const selectedLabels = choices
+      .filter((choice) => selected.has(choice.value))
+      .map((choice) => choice.label);
+    const lines = [
+      `? ${message} (${choices.length} available)`,
+      `Selected: ${selectedLabels.length > 0 ? selectedLabels.join(', ') : '(none)'}`,
+      `Search: ${search || '[type to filter]'}`,
+      '↑↓ navigate • Space toggle • Backspace remove • Enter confirm'
+    ];
+
+    if (visibleChoices.length === 0) {
+      lines.push('  (no matches)');
+    } else {
+      for (let index = 0; index < visibleChoices.length; index += 1) {
+        const choice = visibleChoices[index];
+        const cursor = index === activeIndex ? '›' : ' ';
+        const marker = selected.has(choice.value) ? '◉' : '○';
+        const suffix = selected.has(choice.value) ? ' (selected)' : '';
+        lines.push(`${cursor} ${marker} ${choice.label}${suffix}`);
+      }
+    }
+
+    output.write(`${lines.join('\n')}\n`);
+    renderedLines = lines.length;
+  };
+
+  return await new Promise((resolve, reject) => {
+    emitKeypressEvents(input);
+    input.setRawMode(true);
+    input.resume();
+
+    const cleanup = () => {
+      input.off('keypress', onKeypress);
+      input.setRawMode(false);
+      output.write('\n');
+    };
+
+    const onKeypress = (text, key = {}) => {
+      const visibleChoices = filteredChoices();
+      if (key.ctrl && key.name === 'c') {
+        cleanup();
+        reject(new Error('Platform selection cancelled'));
+        return;
+      }
+      if (key.name === 'return' || key.name === 'enter') {
+        if (selected.size === 0 && visibleChoices[activeIndex]) {
+          selected.add(visibleChoices[activeIndex].value);
+        }
+        cleanup();
+        resolve([...selected]);
+        return;
+      }
+      if (key.name === 'up') {
+        activeIndex = Math.max(0, activeIndex - 1);
+      } else if (key.name === 'down') {
+        activeIndex = Math.min(Math.max(visibleChoices.length - 1, 0), activeIndex + 1);
+      } else if (key.name === 'space' && visibleChoices[activeIndex]) {
+        const value = visibleChoices[activeIndex].value;
+        if (selected.has(value)) {
+          selected.delete(value);
+        } else {
+          selected.add(value);
+        }
+      } else if (key.name === 'backspace') {
+        search = search.slice(0, -1);
+        activeIndex = 0;
+      } else if (text && text.trim() && text.length === 1) {
+        search += text;
+        activeIndex = 0;
+      }
+      render();
+    };
+
+    input.on('keypress', onKeypress);
+    render();
+  });
+}
+
 export async function main(argv = process.argv.slice(2), options = {}) {
   const io = options.io ?? defaultIo();
   const prompt = Object.hasOwn(options, 'prompt') ? options.prompt : defaultPrompt;
+  const selectPlatforms = Object.hasOwn(options, 'selectPlatforms')
+    ? options.selectPlatforms
+    : defaultSelectPlatforms;
   const [command, ...args] = argv;
 
   try {
@@ -57,7 +164,7 @@ export async function main(argv = process.argv.slice(2), options = {}) {
     }
 
     if (command === 'init') {
-      return await runInit(args, { io, prompt });
+      return await runInit(args, { io, prompt, selectPlatforms });
     }
 
     if (command === 'sync') {

package/src/commands/init.js

@@ -7,15 +7,37 @@ import {
   summarizePlan
 } from '../lib/copy-template.js';
 import { readPackageInfo } from '../lib/package-info.js';
+import {
+  SUPPORTED_PLATFORMS,
+  formatPlatformList,
+  parsePlatformSelection
+} from '../lib/platforms.js';
 
 function parseInitArgs(args) {
-  const options = { developer: null, dryRun: false, force: false, target: process.cwd() };
+  const options = {
+    developer: null,
+    dryRun: false,
+    force: false,
+    platforms: [],
+    target: process.cwd()
+  };
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if (arg === '--dry-run') {
       options.dryRun = true;
     } else if (arg === '--force') {
       options.force = true;
+    } else if (arg === '--platform' || arg === '--platforms') {
+      const value = args[index + 1];
+      if (!value || value.startsWith('--')) {
+        throw new Error('Missing value for --platform');
+      }
+      options.platforms.push(value);
+      index += 1;
+    } else if (arg.startsWith('--platform=')) {
+      options.platforms.push(arg.slice('--platform='.length));
+    } else if (arg.startsWith('--platforms=')) {
+      options.platforms.push(arg.slice('--platforms='.length));
     } else if (arg === '--developer') {
       const value = args[index + 1];
       if (!value || value.startsWith('--')) {
@@ -85,6 +107,38 @@ async function resolveDeveloperName(options, prompt) {
   return { existing: false, name: normalizeDeveloperName(name) };
 }
 
+function platformLabel(platform) {
+  if (platform === 'codex') {
+    return 'Codex';
+  }
+  if (platform === 'opencode') {
+    return 'OpenCode';
+  }
+  if (platform === 'claude-code') {
+    return 'Claude Code';
+  }
+  return platform;
+}
+
+async function resolvePlatforms(options, selectPlatforms) {
+  if (options.platforms.length > 0) {
+    return parsePlatformSelection(options.platforms);
+  }
+
+  let selected = null;
+  if (typeof selectPlatforms === 'function') {
+    selected = await selectPlatforms({
+      message: 'Select platforms to set up',
+      choices: SUPPORTED_PLATFORMS.map((platform) => ({
+        label: platformLabel(platform),
+        value: platform
+      })),
+      defaultSelected: ['codex']
+    });
+  }
+  return parsePlatformSelection(selected);
+}
+
 function todayIsoDate() {
   return new Date().toISOString().slice(0, 10);
 }
@@ -170,21 +224,24 @@ async function initializeDeveloper(target, developer) {
   }
 }
 
-export async function runInit(args, { io, prompt }) {
-  return runInitWithOptions(args, { io, prompt });
+export async function runInit(args, { io, prompt, selectPlatforms }) {
+  return runInitWithOptions(args, { io, prompt, selectPlatforms });
 }
 
-export async function runInitWithOptions(args, { io, prompt }) {
+export async function runInitWithOptions(args, { io, prompt, selectPlatforms }) {
   const options = parseInitArgs(args);
+  const platforms = await resolvePlatforms(options, selectPlatforms);
   const developer = await resolveDeveloperName(options, prompt);
   const packageInfo = await readPackageInfo();
   const plan = await buildInitPlan(options.target, {
     force: options.force,
+    platforms,
     version: packageInfo.version
   });
 
   await applyPlan(plan, { dryRun: options.dryRun });
   io.writeOut(summarizePlan(plan, options.dryRun));
+  io.writeOut(`Platforms: ${formatPlatformList(platforms)}\n`);
 
   if (options.dryRun) {
     if (developer.existing) {

package/src/commands/sync.js

@@ -1,7 +1,13 @@
 import { resolve } from 'node:path';
 
-import { applyPlan, buildSyncPlan, summarizePlan } from '../lib/copy-template.js';
+import {
+  applyPlan,
+  buildSyncPlan,
+  detectInstalledPlatforms,
+  summarizePlan
+} from '../lib/copy-template.js';
 import { readPackageInfo } from '../lib/package-info.js';
+import { formatPlatformList } from '../lib/platforms.js';
 
 function parseSyncArgs(args) {
   const options = { dryRun: false, force: false, target: process.cwd() };
@@ -22,12 +28,15 @@ function parseSyncArgs(args) {
 export async function runSync(args, { io }) {
   const options = parseSyncArgs(args);
   const packageInfo = await readPackageInfo();
+  const platforms = await detectInstalledPlatforms(options.target);
   const plan = await buildSyncPlan(options.target, {
     force: options.force,
+    platforms,
     version: packageInfo.version
   });
 
   await applyPlan(plan, { dryRun: options.dryRun });
   io.writeOut(summarizePlan(plan, options.dryRun));
+  io.writeOut(`Platforms: ${platforms.length > 0 ? formatPlatformList(platforms) : 'none'}\n`);
   return 0;
 }

package/src/lib/copy-template.js

@@ -3,6 +3,7 @@ import { access, chmod, copyFile, mkdir, readFile, readdir, stat, writeFile } fr
 import { dirname, join, relative } from 'node:path';
 
 import { templateRoot } from './paths.js';
+import { shouldIncludeForPlatforms } from './platforms.js';
 
 async function pathExists(path) {
   try {
@@ -39,8 +40,13 @@ function toTemplatePath(relativePath) {
 export async function buildInitPlan(targetDir, options = {}) {
   const files = await listFiles(templateRoot);
   const actions = [];
+  const platforms = options.platforms ?? [];
 
   for (const file of files) {
+    if (!shouldIncludeForPlatforms(file, platforms)) {
+      continue;
+    }
+
     if (toTemplatePath(file) === '.cowork-flow/.version') {
       continue;
     }
@@ -79,6 +85,8 @@ const PROTECTED_SYNC_PREFIXES = [
 
 const SAFE_SYNC_PREFIXES = [
   '.codex/',
+  '.opencode/',
+  '.claude/',
   '.agent/skills/',
   '.cowork-flow/'
 ];
@@ -87,7 +95,8 @@ const SAFE_SYNC_FILES = new Set([
   '.cowork-flow/.gitignore',
   '.cowork-flow/.version',
   '.cowork-flow/run',
-  '.cowork-flow/run.cmd'
+  '.cowork-flow/run.cmd',
+  '.cowork-flow/spec/workflow-state-templates.md'
 ]);
 
 const COWORK_FLOW_START = '<!-- COWORK-FLOW:START -->';
@@ -95,6 +104,9 @@ const COWORK_FLOW_END = '<!-- COWORK-FLOW:END -->';
 
 function isProtectedSyncFile(relativePath) {
   const templatePath = toTemplatePath(relativePath);
+  if (SAFE_SYNC_FILES.has(templatePath)) {
+    return false;
+  }
   return PROTECTED_SYNC_FILES.has(templatePath)
     || PROTECTED_SYNC_PREFIXES.some((prefix) => templatePath.startsWith(prefix));
 }
@@ -125,13 +137,13 @@ function replaceManagedBlock(targetContent, templateContent) {
   ].join('');
 }
 
-async function buildAgentsSyncAction({ source, destination, exists, options }) {
+async function buildManagedBlockSyncAction({ source, destination, exists, options, relativePath }) {
   if (!exists || options.force) {
     return {
       action: exists ? 'update' : 'create',
       source,
       destination,
-      relativePath: 'AGENTS.md'
+      relativePath
     };
   }
 
@@ -142,10 +154,10 @@ async function buildAgentsSyncAction({ source, destination, exists, options }) {
   const content = replaceManagedBlock(targetContent, templateContent);
 
   if (content === null) {
-    return { action: 'protected', source, destination, relativePath: 'AGENTS.md' };
+    return { action: 'protected', source, destination, relativePath };
   }
 
-  return { action: 'update', source, destination, relativePath: 'AGENTS.md', content };
+  return { action: 'update', source, destination, relativePath, content };
 }
 
 export async function buildSyncPlan(targetDir, options = {}) {
@@ -155,8 +167,13 @@ export async function buildSyncPlan(targetDir, options = {}) {
 
   const files = await listFiles(templateRoot);
   const actions = [];
+  const platforms = options.platforms ?? await detectInstalledPlatforms(targetDir);
 
   for (const file of files) {
+    if (!shouldIncludeForPlatforms(file, platforms)) {
+      continue;
+    }
+
     if (toTemplatePath(file) === '.cowork-flow/.version') {
       continue;
     }
@@ -164,8 +181,8 @@ export async function buildSyncPlan(targetDir, options = {}) {
     const source = join(templateRoot, file);
     const destination = join(targetDir, file);
     const exists = await pathExists(destination);
-    if (file === 'AGENTS.md') {
-      actions.push(await buildAgentsSyncAction({ source, destination, exists, options }));
+    if (file === 'AGENTS.md' || file === 'CLAUDE.md') {
+      actions.push(await buildManagedBlockSyncAction({ source, destination, exists, options, relativePath: file }));
       continue;
     }
 
@@ -194,6 +211,20 @@ export async function buildSyncPlan(targetDir, options = {}) {
   return actions;
 }
 
+export async function detectInstalledPlatforms(targetDir) {
+  const platforms = [];
+  if (await pathExists(join(targetDir, '.codex'))) {
+    platforms.push('codex');
+  }
+  if (await pathExists(join(targetDir, '.opencode'))) {
+    platforms.push('opencode');
+  }
+  if (await pathExists(join(targetDir, '.claude')) || await pathExists(join(targetDir, 'CLAUDE.md'))) {
+    platforms.push('claude-code');
+  }
+  return platforms;
+}
+
 export function summarizePlan(actions, dryRun = false) {
   const counts = { create: 0, update: 0, skip: 0, protected: 0 };
   for (const action of actions) {

package/src/lib/platforms.js

@@ -0,0 +1,73 @@
+export const SUPPORTED_PLATFORMS = ['codex', 'opencode', 'claude-code'];
+
+const LEGACY_BOTH_PLATFORMS = ['codex', 'opencode'];
+
+const PLATFORM_ALIASES = new Map([
+  ['all', SUPPORTED_PLATFORMS],
+  ['both', LEGACY_BOTH_PLATFORMS],
+  ['codex', ['codex']],
+  ['opencode', ['opencode']],
+  ['claude', ['claude-code']],
+  ['claude-code', ['claude-code']],
+  ['claudecode', ['claude-code']]
+]);
+
+export function supportedPlatformMessage() {
+  return SUPPORTED_PLATFORMS.join(', ');
+}
+
+export function parsePlatformSelection(values) {
+  const rawValues = Array.isArray(values) ? values : [values];
+  const selected = new Set();
+
+  for (const rawValue of rawValues) {
+    const tokens = String(rawValue ?? '')
+      .toLowerCase()
+      .split(/[\s,;|+/]+/)
+      .map((token) => token.trim())
+      .filter(Boolean);
+
+    for (const token of tokens) {
+      const platforms = PLATFORM_ALIASES.get(token);
+      if (!platforms) {
+        throw new Error(`Unsupported platform: ${token}. Supported platforms: ${supportedPlatformMessage()}`);
+      }
+      for (const platform of platforms) {
+        selected.add(platform);
+      }
+    }
+  }
+
+  if (selected.size === 0) {
+    throw new Error(
+      'Platform selection required. Run: cowork-flow init <target> --platform codex|opencode|claude-code'
+    );
+  }
+
+  return SUPPORTED_PLATFORMS.filter((platform) => selected.has(platform));
+}
+
+export function formatPlatformList(platforms) {
+  return platforms.join(', ');
+}
+
+export function shouldIncludeForPlatforms(relativePath, platforms) {
+  const normalized = relativePath.replaceAll('\\', '/');
+  if (normalized.startsWith('.agent/skills/')) {
+    return platforms.includes('codex') || platforms.includes('opencode');
+  }
+  if (normalized.startsWith('.codex/') || normalized.startsWith('.cowork-flow/adapters/codex/')) {
+    return platforms.includes('codex');
+  }
+  if (normalized.startsWith('.opencode/') || normalized.startsWith('.cowork-flow/adapters/opencode/')) {
+    return platforms.includes('opencode');
+  }
+  if (
+    normalized === 'CLAUDE.md'
+    || normalized.startsWith('.claude/')
+    || normalized.startsWith('.cowork-flow/adapters/claude-code/')
+  ) {
+    return platforms.includes('claude-code');
+  }
+  return true;
+}