cowork-flow 0.0.4 → 0.0.7

package/template/.cowork-flow/scripts/common/config.py

@@ -15,6 +15,7 @@ from .paths import DIR_WORKFLOW, get_repo_root
 # Defaults
 DEFAULT_SESSION_COMMIT_MESSAGE = "chore: record journal"
 DEFAULT_MAX_JOURNAL_LINES = 2000
+DEFAULT_AGENT_TEAM_ENABLED = False
 
 CONFIG_FILE = "config.yaml"
 
@@ -108,6 +109,23 @@ def get_max_journal_lines(repo_root: Path | None = None) -> int:
         return DEFAULT_MAX_JOURNAL_LINES
 
 
+def _is_true(value: object) -> bool:
+    if value is True:
+        return True
+    if isinstance(value, str):
+        return value.strip().lower() == "true"
+    return False
+
+
+def get_agent_team_enabled(repo_root: Path | None = None) -> bool:
+    """Return whether agent-team runtime commands are enabled."""
+    config = _load_config(repo_root)
+    agent_team = config.get("agent_team")
+    if not isinstance(agent_team, dict):
+        return DEFAULT_AGENT_TEAM_ENABLED
+    return _is_true(agent_team.get("enabled"))
+
+
 def get_hooks(event: str, repo_root: Path | None = None) -> list[str]:
     """Get hook commands for a lifecycle event.
 

package/template/.cowork-flow/scripts/common/git_context.py

@@ -253,6 +253,13 @@ def _task_plan_references(repo_root: Path, snapshot: CurrentTaskSnapshot) -> lis
     return plan_refs
 
 
+def _task_has_agent_team_status(repo_root: Path, snapshot: CurrentTaskSnapshot) -> bool:
+    """Return whether the current task has persisted agent-team runtime state."""
+    if not snapshot.path:
+        return False
+    return (repo_root / snapshot.path / "agent-team" / "status.json").is_file()
+
+
 def _build_resume_checklist(
     repo_root: Path,
     snapshot: CurrentTaskSnapshot,
@@ -269,6 +276,9 @@ def _build_resume_checklist(
 
     current_task = snapshot.path
     commands.append(f"./{DIR_WORKFLOW}/run task list-context {current_task}")
+    if _task_has_agent_team_status(repo_root, snapshot):
+        commands.append(f"./{DIR_WORKFLOW}/run agent-team status {current_task}")
+        commands.append(f"./{DIR_WORKFLOW}/run agent-team next {current_task}")
 
     if snapshot.has_prd:
         read_files.append(f"{current_task}/prd.md")
@@ -329,6 +339,13 @@ def _append_resume_checklist(
     else:
         lines.append("- No plan reference found in task context; do not search all plans unless needed.")
 
+    agent_team_commands = [
+        command for command in commands if f"./{DIR_WORKFLOW}/run agent-team " in command
+    ]
+    if agent_team_commands:
+        lines.append(f"- Check agent-team status: {agent_team_commands[0]}")
+        lines.append(f"- Continue agent-team dispatch: {agent_team_commands[1]}")
+
     lines.append("- Do not bulk-read .cowork-flow/spec/ or workspace journals; follow JSONL references on demand.")
     lines.append("")
 

package/template/.cowork-flow/scripts/common/task_utils.py

@@ -10,11 +10,11 @@ Provides:
 
 from __future__ import annotations
 
-import shutil
 import sys
 from datetime import datetime
 from pathlib import Path
 
+from .archive_utils import archive_directory_resumable
 from .paths import get_repo_root
 
 PATH_TRAVERSAL_PREFIXES = ("./", "../")
@@ -139,23 +139,10 @@ def archive_task_dir(task_dir_abs: Path, repo_root: Path | None = None) -> Path
     task_name = task_dir_abs.name
     archive_dest = month_dir / task_name
 
-    if archive_dest.exists():
-        print(f"Error: archive target already exists: {archive_dest}", file=sys.stderr)
-        print(f"Source task directory is still present: {task_dir_abs}", file=sys.stderr)
-        return None
-
-    try:
-        shutil.move(str(task_dir_abs), str(archive_dest))
-    except (OSError, IOError, shutil.Error) as e:
-        print(f"Error: Failed to move task to archive: {e}", file=sys.stderr)
-        if archive_dest.exists() and task_dir_abs.exists():
-            print("Error: archive move left both source and target paths present.", file=sys.stderr)
-            print(f"  Source: {task_dir_abs}", file=sys.stderr)
-            print(f"  Target: {archive_dest}", file=sys.stderr)
-        elif archive_dest.exists():
-            print(f"Error: archive target path exists after failure: {archive_dest}", file=sys.stderr)
-        elif task_dir_abs.exists():
-            print(f"Error: source task directory is still present: {task_dir_abs}", file=sys.stderr)
+    result = archive_directory_resumable(task_dir_abs, archive_dest)
+    if not result.ok:
+        level = "Warning" if result.partial else "Error"
+        print(f"{level}: {result.message}", file=sys.stderr)
         return None
 
     return archive_dest

package/template/.cowork-flow/scripts/run.py

@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Shared cowork-flow command dispatcher."""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+COMMAND_SCRIPTS = {
+    "resume": "resume.py",
+    "task": "task.py",
+    "change": "change.py",
+    "get-context": "get_context.py",
+    "get_context": "get_context.py",
+    "get-developer": "get_developer.py",
+    "get_developer": "get_developer.py",
+    "init-developer": "init_developer.py",
+    "init_developer": "init_developer.py",
+    "add-session": "add_session.py",
+    "add_session": "add_session.py",
+    "agent-team": "agent_team.py",
+    "agent_team": "agent_team.py",
+}
+
+
+def print_usage() -> None:
+    print(
+        """Usage:
+  ./.cowork-flow/run <command> [args...]
+  ./.cowork-flow/run python [python-args...]
+
+Common commands:
+  resume
+  task
+  change
+  get-context
+  get-developer
+  init-developer
+  add-session
+  agent-team
+""".rstrip()
+    )
+
+
+def scripts_dir() -> Path:
+    return Path(__file__).resolve().parent
+
+
+def run_python(args: list[str]) -> int:
+    completed = subprocess.run([sys.executable, *args], check=False)
+    return int(completed.returncode)
+
+
+def run_script(script_name: str, args: list[str]) -> int:
+    script_path = scripts_dir() / script_name
+    if not script_path.is_file():
+        print(f"Error: script not found: {script_path}", file=sys.stderr)
+        return 2
+    return run_python([str(script_path), *args])
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+    if not args:
+        print_usage()
+        return 2
+
+    command = args[0]
+    rest = args[1:]
+    if command in {"-h", "--help", "help"}:
+        print_usage()
+        return 0
+    if command == "python":
+        return run_python(rest)
+
+    script_name = COMMAND_SCRIPTS.get(command)
+    if script_name is None:
+        candidate = scripts_dir() / f"{command}.py"
+        if candidate.is_file():
+            script_name = candidate.name
+        else:
+            print(f"Error: unknown cowork-flow command: {command}", file=sys.stderr)
+            print_usage()
+            return 2
+
+    return run_script(script_name, rest)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/template/.cowork-flow/scripts/task.py

@@ -932,7 +932,7 @@ def cmd_start(args: argparse.Namespace) -> int:
 
     # Convert to relative path for storage
     try:
-        task_dir = str(full_path.relative_to(repo_root))
+        task_dir = full_path.relative_to(repo_root).as_posix()
     except ValueError:
         task_dir = str(full_path)
 

package/template/.cowork-flow/workflow.md

@@ -8,47 +8,19 @@
 获取上下文 -> 阅读规范 -> 任务分级 -> 规格与计划 -> 执行实现 -> 验证审阅 -> 状态同步 -> session 记录
 ```
 
-所有任务都应先明确目标和验收标准，再进入实现；所有完成结论都必须有验证证据支撑。
-
-命令示例默认使用 macOS / Linux / Git Bash / WSL 写法；Windows cmd / PowerShell 中使用 `.\.cowork-flow\run.cmd <command>` 替代 `./.cowork-flow/run <command>`。
+所有任务先明确目标和验收标准，再进入实现；所有完成结论都必须有验证证据。命令示例默认使用 macOS / Linux / Git Bash / WSL；Windows cmd / PowerShell 使用 `.\.cowork-flow\run.cmd <command>` 替代 `./.cowork-flow/run <command>`。
 
 ---
 
 ## 2. 职责边界
 
-### 2.1 cowork-flow change
-
-`cowork-flow change` 负责行为变更治理：
-
-- proposal：为什么要改
-- spec：外部行为与验收标准
-- design：重要设计取舍，主要用于复杂或跨层变更
-- change.yaml：变更状态、分级、关联 plan / task
-- archive：完成后的行为规格归档
-
-### 2.2 superpowers
-
-`superpowers` 负责工作方法：
-
-- `superpowers:brainstorming`：澄清需求、比较方案、形成设计
-- `superpowers:writing-plans`：把设计拆成可执行计划
-- `superpowers:test-driven-development` 是实现阶段的强制方法。除一次性原型、生成代码、纯配置文件等明确例外并经人工确认外，功能新增、缺陷修复、重构和行为变更都必须按 RED-GREEN-REFACTOR 推进：先写失败测试并确认失败原因正确，再写最小实现使测试通过，最后在测试保护下重构。复杂或难点问题：深度优先
-- `superpowers:executing-plans`：按计划顺序执行
-- `superpowers:subagent-driven-development`：在适合时并行拆分独立工作
-- `superpowers:verification-before-completion`：完成前用证据验证
-
-### 2.3 任务状态与上下文
+| 对象 | 负责内容 |
+|------|----------|
+| `cowork-flow change` | 行为变更治理：`proposal` 说明为什么改，`spec` 定义外部行为与验收标准，`design` 记录复杂或跨层设计取舍，`change.yaml` 保存状态/分级/关联 plan 与 task，`archive` 归档完成后的行为规格。 |
+| `superpowers` | 工作方法：`brainstorming` 澄清需求和方案，`writing-plans` 拆可执行计划，`test-driven-development` 约束实现，`executing-plans` 顺序执行，`subagent-driven-development` 并行拆分，`verification-before-completion` 完成前取证。 |
+| `.cowork-flow` | 任务状态和上下文：当前开发者、当前任务、PRD、`implement/check/debug` 上下文、journal、session 记录和任务归档。 |
 
-`.cowork-flow` 负责承载任务状态与上下文：
-
-- 当前开发者身份
-- 当前任务
-- 任务 PRD
-- implement / check / debug 上下文
-- journal 与 session 记录
-- 任务归档
-
-执行按 superpowers 方法推进；`.cowork-flow` 不替代 superpowers，也不替代项目验证命令。
+`.cowork-flow` 不替代 superpowers，也不替代项目验证命令。除一次性原型、生成代码、纯配置文件等明确例外并经人工确认外，功能新增、缺陷修复、重构和行为变更都必须按 RED-GREEN-REFACTOR 推进；复杂或难点问题按深度优先。
 
 ---
 
@@ -58,8 +30,8 @@
 2. **规格先行**：有行为变化时，先补规格，再写计划，再实现。
 3. **计划后编码**：复杂或行为变更任务必须先形成可执行计划。
 4. **上下文显式化**：不要依赖记忆，把关键规范、设计、计划写入任务上下文。
-5. **一次一个任务**：避免在多个无关任务之间来回切换。
-6. **执行中回写状态**：计划、任务状态、change metadata 和 journal 不应长期漂移。
+5. **一次一个任务**：避免在多个无关任务之间切换。
+6. **执行中回写状态**：plan、task、change metadata 和 journal 不应长期漂移。
 7. **证据先于结论**：未验证前不声称完成、通过或可交付。
 8. **经验沉淀回规范**：实现中发现的契约、坑点、规则应更新到 `.cowork-flow/spec/`。
 
@@ -69,15 +41,13 @@
 
 ### 4.1 初始化开发者身份
 
-首次进入项目时执行：
+首次进入项目时执行；如果已经存在开发者身份，只需读取当前身份。
 
 ```bash
 ./.cowork-flow/run get-developer
 ./.cowork-flow/run init-developer <developer-name>
 ```
 
-如果已经存在开发者身份，只需读取当前身份。
-
 ### 4.2 获取当前上下文
 
 每次开始工作先执行：
@@ -89,13 +59,7 @@ git status
 git log --oneline -10
 ```
 
-至少确认：
-
-- 当前开发者是谁
-- 是否存在当前任务
-- 是否存在未归档任务
-- 工作区是否干净
-- 最近提交是否影响当前任务
+至少确认当前开发者、当前任务、未归档任务、工作区状态，以及最近提交是否影响当前任务。
 
 ### 4.3 阅读固定入口文件
 
@@ -116,51 +80,11 @@ done
 
 所有任务先分级，再选择流程。
 
-### 5.1 L0：无外部行为变化
-
-适用场景：
-
-- 文档整理
-- 小范围重构
-- 测试补充
-- 注释、格式、脚本清理
-- 不改变用户可观察行为的内部调整
-
-流程：
-
-```text
-任务 -> 读取规范 -> 简短计划 -> 实现 -> 验证 -> 记录 session
-```
-
-### 5.2 L1：局部行为变化
-
-适用场景：
-
-- 单模块功能调整
-- 单接口行为变化
-- 局部数据处理逻辑变化
-- 有明确边界的新能力
-
-流程：
-
-```text
-cowork-flow change -> brainstorming -> writing-plans -> 任务上下文 -> 执行计划 -> 验证 -> 归档与记录
-```
-
-### 5.3 L2：跨层或重要行为变化
-
-适用场景：
-
-- 跨前后端或跨服务变更
-- API / DB / 消息 / 缓存 / 文件等契约变化
-- 架构边界变化
-- 影响发布、迁移、安全、权限或兼容性的变更
-
-流程：
-
-```text
-cowork-flow change -> brainstorming -> design.md -> writing-plans -> 任务上下文 -> 执行计划 -> 多视角审阅 -> 验证 -> 归档与记录
-```
+| 等级 | 适用场景 | 流程 |
+|------|----------|------|
+| L0：无外部行为变化 | 文档整理、小范围重构、测试补充、注释/格式/脚本清理、不改变用户可观察行为的内部调整 | 任务 -> 读取规范 -> 简短计划 -> 实现 -> 验证 -> 记录 session |
+| L1：局部行为变化 | 单模块功能调整、单接口行为变化、局部数据处理逻辑变化、有明确边界的新能力 | cowork-flow change -> brainstorming -> writing-plans -> 任务上下文 -> 执行计划 -> 验证 -> 归档与记录 |
+| L2：跨层或重要行为变化 | 跨前后端或跨服务变更；API / DB / 消息 / 缓存 / 文件等契约变化；架构边界变化；影响发布、迁移、安全、权限或兼容性的变更 | cowork-flow change -> brainstorming -> design.md -> writing-plans -> 任务上下文 -> 执行计划 -> 多视角审阅 -> 验证 -> 归档与记录 |
 
 ---
 
@@ -175,13 +99,7 @@ cowork-flow change -> brainstorming -> design.md -> writing-plans -> 任务上
 
 ### 6.2 写入任务 PRD
 
-在任务目录创建或更新 `prd.md`，至少包含：
-
-- 目标
-- 范围
-- 验收标准
-- 相关文件或模块
-- 验证方式
+在任务目录创建或更新 `prd.md`，至少包含：目标、范围、验收标准、相关文件或模块、验证方式。
 
 ### 6.3 初始化任务上下文
 
@@ -189,13 +107,7 @@ cowork-flow change -> brainstorming -> design.md -> writing-plans -> 任务上
 ./.cowork-flow/run task init-context <task-dir> <type>
 ```
 
-`<type>` 按任务选择：
-
-- `backend`
-- `frontend`
-- `fullstack`
-- `test`
-- `docs`
+`<type>` 按任务选择：`backend`、`frontend`、`fullstack`、`test`、`docs`。
 
 ### 6.4 补充任务上下文
 
@@ -214,11 +126,11 @@ cowork-flow change -> brainstorming -> design.md -> writing-plans -> 任务上
 
 执行要求：
 
-- 按 `prd.md` 和上下文实现
-- 遵循 `.cowork-flow/spec/` 中的相关规范
-- 变更保持聚焦
-- 若执行中发现行为变化升级，立即重新分级并进入 L1 / L2 流程
-- 执行计划中的每个实现步骤必须优先进入 `superpowers:test-driven-development` 循环,不得先写生产代码再补测试。
+- 按 `prd.md` 和上下文实现。
+- 遵循 `.cowork-flow/spec/` 中的相关规范。
+- 变更保持聚焦。
+- 若执行中发现行为变化升级，立即重新分级并进入 L1 / L2 流程。
+- 执行计划中的每个实现步骤必须优先进入 `superpowers:test-driven-development` 循环，不得先写生产代码再补测试。
 
 ---
 
@@ -252,47 +164,59 @@ cowork-flow change -> brainstorming -> design.md -> writing-plans -> 任务上
 .cowork-flow/plans/YYYY-MM-DD-<slug>.md
 ```
 
-计划必须包含：
-
-- 可勾选步骤
-- 每步验证方式
-- 当前执行状态
-- 阻塞与决策记录位置
+计划必须包含可勾选步骤、每步验证方式、当前执行状态、阻塞与决策记录位置。
 
 ### 7.5 同步计划与状态边界
 
-`.cowork-flow/changes/<slug>/` 只保存 proposal、design、behavior specs 和 change.yaml。
-实现 checklist 只保存在 `.cowork-flow/plans/*.md`。
-任务运行状态只保存在 `.cowork-flow/tasks/`。
-
-不要在 change 目录中维护实现 checklist，避免维护两套细节状态。
+- `.cowork-flow/changes/<slug>/` 只保存 proposal、design、behavior specs 和 `change.yaml`。
+- 实现 checklist 只保存在 `.cowork-flow/plans/*.md`。
+- 任务运行状态只保存在 `.cowork-flow/tasks/`。
+- 不要在 change 目录中维护实现 checklist，避免维护两套细节状态。
 
 ### 7.6 创建或绑定任务
 
-将以下内容加入任务上下文：
-
-- proposal
-- spec
-- design，如存在
-- implementation plan
-- 相关 `.cowork-flow/spec/`
-- 相关代码模式或契约文件
+将 proposal、spec、design（如存在）、implementation plan、相关 `.cowork-flow/spec/`、相关代码模式或契约文件加入任务上下文。
 
 ### 7.7 按 superpowers 方法执行
 
-执行时使用：
+执行 plan 前，先判断**是否存在适合并行执行的独立任务**。并行是优化手段，不是完成定义；`agent_team.enabled` 只决定在适合并行时优先使用哪种机制，不决定是否必须并行。
+
+适合并行的条件包括：
 
-- `superpowers:executing-plans`
-- 或在存在独立并行工作时使用 `superpowers:subagent-driven-development`
-- `superpowers:test-driven-development` 不得先写生产代码再补测试。
+- 子任务之间没有共享写文件，或共享写文件已有明确顺序边界。
+- 子任务之间没有强顺序依赖。
+- 每个子任务都有清晰输入、输出和验收方式。
+- 主 agent 能在集成前独立审查每个结果。
+- 并行带来的收益大于调度、审阅和集成成本。
+
+不适合并行的情况包括：
+
+- 改动集中在同一组强耦合文件。
+- 需要密集的 TDD 红绿循环或即时反馈。
+- parser、schema、runtime、测试需要同步演进。
+- 子任务边界不清，拆分后的主要成本会落在集成。
+- 任务规模小于并行调度成本。
+
+不得为了满足流程形式而强行拆分高耦合任务。若不适合并行，必须简要记录不使用并行的理由，并在当前会话中按 plan 顺序执行。
+
+若适合并行：
+
+- 当 `.cowork-flow/config.yaml` 中设置 `agent_team.enabled: true` 时，使用 `./.cowork-flow/run agent-team prepare <task-dir> --plan <plan-file>` 生成调度图，再用 `./.cowork-flow/run agent-team next <task-dir>` 获取可并行 assignments，由主 agent 审核并调度 subAgent。
+- 当 `.cowork-flow/config.yaml` 中设置 `agent_team.enabled: false` 且宿主支持 subAgent 时，可使用 `superpowers:subagent-driven-development` 开启多 agent 并行执行。
+- 当宿主不支持 subAgent 或任务不适合并行时，使用 `superpowers:executing-plans` 或当前会话顺序执行。
+
+无论是否并行，都必须严格遵循 `superpowers:test-driven-development`，不得先写生产代码再补测试。
 
 执行中必须持续同步：
 
 - plan checkbox
 - plan 当前执行状态
 - 任务状态
+- agent-team status / result / review / retry 工件，如本次执行启用了 agent team
 - 必要的 `.cowork-flow/spec/` 更新
 
+启用 agent team 时，主 agent 仍是协调者：负责审核并行安全性、补充上下文、处理阻塞、集成结果，并在完成前运行 `./.cowork-flow/run agent-team complete <task-dir>`。
+
 ---
 
 ## 8. 验证与审阅
@@ -321,14 +245,7 @@ cowork-flow change -> brainstorming -> design.md -> writing-plans -> 任务上
 
 ### 8.3 L2 额外审阅
 
-L2 任务完成前需要多视角审阅：
-
-- 行为契约
-- 数据流
-- 错误处理
-- 兼容性
-- 测试覆盖
-- 发布或迁移风险
+L2 任务完成前需要多视角审阅：行为契约、数据流、错误处理、兼容性、测试覆盖、发布或迁移风险。
 
 ---
 
@@ -336,13 +253,7 @@ L2 任务完成前需要多视角审阅：
 
 ### 9.1 收尾前同步状态
 
-结束前确认：
-
-- 当前 task 状态准确
-- plan checkbox 与真实进度一致
-- change metadata 与 plan 高层状态一致
-- `.cowork-flow/spec/` 已沉淀必要经验
-- 工作区状态清晰
+结束前确认当前 task 状态、plan checkbox、change metadata、必要的 `.cowork-flow/spec/` 沉淀和工作区状态都与真实进度一致。
 
 ### 9.2 记录 session
 
@@ -370,7 +281,7 @@ L2 任务完成前需要多视角审阅：
 
 ---
 
-## 10. 状态持久化规则
+## 10. 状态持久化与恢复
 
 长任务必须把关键状态写入文件，而不是只留在聊天上下文中。
 
@@ -387,11 +298,7 @@ L2 任务完成前需要多视角审阅：
 
 如果状态只存在于对话中，就不能视为可靠流程状态。
 
----
-
-## 11. 恢复与上下文压缩
-
-多轮对话、长任务、中断恢复或上下文压缩后，必须先走最小恢复层，再按需读取细节。
+### 10.1 恢复分层
 
 | 层级 | 读取内容 | 使用时机 |
 |------|----------|----------|
@@ -399,7 +306,7 @@ L2 任务完成前需要多视角审阅：
 | 任务执行层 | 当前任务 `prd.md`、当前 plan 状态、`task.py list-context <task-dir>` | 准备继续实现或检查前 |
 | 细节规范层 | jsonl 指向的具体 spec、代码模式或计划段落 | 当前修改确实需要该细节时 |
 
-恢复规则：
+### 10.2 恢复规则
 
 - 先执行 `./.cowork-flow/run resume`。
 - 按 `RESUME CHECKLIST` 读取当前 PRD、当前 plan 和 `list-context` 输出。
@@ -411,7 +318,7 @@ L2 任务完成前需要多视角审阅：
 
 ---
 
-## 12. 禁止事项
+## 11. 禁止事项
 
 - 不跳过上下文读取直接编码。
 - 不在未验证时声称完成。
@@ -422,7 +329,7 @@ L2 任务完成前需要多视角审阅：
 
 ---
 
-## 13. 完成定义
+## 12. 完成定义
 
 一个任务只有在以下条件同时满足时，才算完成：
 

package/template/.superpowers/executing-plans/SKILL.md

@@ -13,6 +13,8 @@ Load plan, review critically, execute all tasks, report when complete.
 
 **Note:** Tell your human partner that Superpowers works much better with access to subagents. The quality of its work will be significantly higher if run on a platform with subagent support (such as Claude Code or Codex). If subagents are available, use superpowers:subagent-driven-development instead of this skill.
 
+If the project includes cowork-flow `agent-team` runtime and the plan has independent tasks, prefer `agent-team-execution` so dispatch plans, results, reviews, retries, and metrics are persisted in the task directory.
+
 ## The Process
 
 ### Step 1: Load and Review Plan

package/template/AGENTS.md

@@ -106,8 +106,9 @@
 3. 任何会修改仓库文件的请求，都必须先分级为 `L0` / `L1` / `L2`，再进入对应流程；不要把“很小”当成可以绕过流程的理由。
 4. `L1` / `L2` 行为变更必须先有 `change -> spec -> plan`；`L2` 还必须有 `design.md`，然后才能进入实现。
 5. 实现前必须把任务上下文写入 `.cowork-flow/tasks/<task>/implement.jsonl`、`check.jsonl`、`debug.jsonl`，并在 `start` 之后再改代码。
-6. 收尾前必须跑验证、同步 plan / task / change 状态，完成 `finish-work` 检查，再按项目策略记录 session。
-7. 多轮对话、长任务恢复或上下文压缩后，先运行 `./.cowork-flow/run resume` 并查看 `RESUME CHECKLIST`；只读取清单列出的 PRD、当前 plan 和 jsonl 引用，不要全量重读 `.cowork-flow/spec/` 或历史 journal。
+6. 执行 plan 时，如存在可独立并行任务，且 `.cowork-flow/config.yaml` 中已设置 `agent_team.enabled: true`，可使用 `./.cowork-flow/run agent-team prepare <task-dir> --plan <plan-file>` 与 `agent-team next` 生成并执行 agent-team 调度；主 agent 仍负责协调、审阅和状态回写。
+7. 收尾前必须跑验证、同步 plan / task / change 状态，完成 `finish-work` 检查，再按项目策略记录 session。
+8. 多轮对话、长任务恢复或上下文压缩后，先运行 `./.cowork-flow/run resume` 并查看 `RESUME CHECKLIST`；只读取清单列出的 PRD、当前 plan 和 jsonl 引用，不要全量重读 `.cowork-flow/spec/` 或历史 journal。
 
 Use the `.agent/skills/start` skill when starting a new session to:
 - Initialize your developer identity