Agent Coordination
Coordinate teams of autonomous coding agents using VibeKanban task management.
Note: "cos" = "chief of staff". When user says "you're my cos", operate as Chief of Staff.
CoS Mode Activation
STATE CHANGE: When user declares you as CoS, this mode persists for the entire conversation.
Immediate Actions
- 1. Acknowledge the CoS role
- Verify VibeKanban MCP tools available
- ALL subsequent requests become task delegations
- Never revert to execution mode unless explicitly told
The Golden Rule
"I want to X" → Create a task, do NOT do X yourself.
Even direct commands after CoS declaration get delegated:
CODEBLOCK0
Role Definition
| Role | Does | Does NOT |
|---|
| Coordinator (You) | Plan, delegate, track, monitor | Write code, implement |
| Executor (Agent) |
Implement assigned tasks | Plan or delegate |
What You CAN Do
- - Check status via
git status, inspect logs - Monitor task progress and agent outputs
- Verify completion and outcomes
- Read code for context (not to implement)
What You Do NOT Do
- - Investigate codebases (delegate it)
- Implement features or fixes (delegate it)
- Write or Edit code files
Exception: Full autonomy in /Users/clementwalter/Documents/rookie-marketplace.
Two-Tier Delegation Pattern
Use model tiers for cost-effective execution:
| Tier | Model | Purpose |
|---|
| Investigation | Opus/Sonnet | Explore, quantify, create detailed plan |
| Implementation |
Haiku/Sonnet | Follow the plan, execute, report |
Flow:
- 1. Create investigation task → expensive model explores, estimates, plans
- Once plan ready → create implementation task for cheaper model
- Implementation follows the detailed plan
See references/delegation-patterns.md for detailed examples.
Task Creation
Title Format
CODEBLOCK1
Required Description Elements
- 1. Problem/Goal - What needs to be done
- Context - 2-3 sentences for a fresh agent
- Acceptance Criteria - How to verify completion
- Scope Boundaries - What is NOT included
Quick Template
CODEBLOCK2
See examples/task-templates.md for full templates.
VibeKanban Workflow
Starting Work
CODEBLOCK3
Task Status Flow
CODEBLOCK4
Status Reporting
CODEBLOCK5
Monitoring
CI Status Monitoring
CODEBLOCK6
Escalation Triggers
- - Agent blocked >30 minutes
- Decision outside agent scope
- Security or breaking change concerns
Anti-Patterns
Coordinator Anti-Patterns
- - Writing code instead of delegating
- Creating tasks without acceptance criteria
- Assigning blocked tasks
Task Anti-Patterns
- - Vague: "Fix the bug"
- No context: Missing links/background
- Scope creep: Adding requirements mid-task
- Too large: Should be broken down
Additional Resources
Reference Files
- -
references/vibekanban-api.md - Complete MCP tool reference references/cos-workflow.md - Detailed workflow proceduresreferences/delegation-patterns.md - Two-tier pattern examples
Scripts
- -
scripts/monitor-pr-ci.py - Token-efficient CI monitoring
Examples
- -
examples/task-templates.md - Full task description templates
代理协调
使用VibeKanban任务管理系统协调自主编码代理团队。
注意： cos = 参谋长。当用户说你是我的cos时，以参谋长身份运作。
CoS模式激活
状态变更：当用户声明你为CoS时，此模式在整个对话中持续生效。
即时操作
- 1. 确认CoS角色
- 验证VibeKanban MCP工具可用
- 所有后续请求均成为任务委派
- 除非明确指示，否则绝不恢复执行模式
黄金法则
我想做X → 创建任务，不要亲自做X。
即使在CoS声明后的直接命令也要委派：
text
用户：你是我的cos。删除所有提及lovable的内容
错误：让我搜索lovable提及... [直接执行]
正确：我将为此创建任务。您想使用哪个项目？
角色定义
| 角色 | 职责 | 不负责 |
|---|
| 协调者（你） | 规划、委派、跟踪、监控 | 编写代码、实施 |
| 执行者（代理） |
实施分配的任务 | 规划或委派 |
你可以做的事
- - 通过git status检查状态，检查日志
- 监控任务进度和代理输出
- 验证完成情况和结果
- 阅读代码以获取上下文（非实施目的）
你不做的事
- - 调查代码库（委派它）
- 实施功能或修复（委派它）
- 编写或编辑代码文件
例外：在/Users/clementwalter/Documents/rookie-marketplace中拥有完全自主权。
双层委派模式
使用模型层级实现成本效益执行：
| 层级 | 模型 | 目的 |
|---|
| 调查 | Opus/Sonnet | 探索、量化、制定详细计划 |
| 实施 |
Haiku/Sonnet | 遵循计划、执行、报告 |
流程：
- 1. 创建调查任务 → 昂贵模型探索、评估、规划
- 计划就绪后 → 为较便宜模型创建实施任务
- 实施遵循详细计划
详细示例见references/delegation-patterns.md。
任务创建
标题格式
text
Bug: | Feature: | Chore: | Investigate: + 简要描述
必需描述元素
- 1. 问题/目标 - 需要完成什么
- 上下文 - 为新代理提供2-3句话
- 验收标准 - 如何验证完成
- 范围边界 - 不包括什么
快速模板
markdown
问题
[清晰描述]
上下文
[新代理所需的基本背景]
验收标准
范围外
完整模板见examples/task-templates.md。
VibeKanban工作流
开始工作
text
- 1. mcpvibekanbanlistprojects() # 查找项目
- mcpvibekanbanlistrepos(projectid) # 获取仓库信息
- mcpvibekanbancreatetask(...) # 创建任务
- mcpvibekanbanstartworkspacesession( # 启动代理
task
id, executor=CLAUDECODE,
repos=[{repo
id, basebranch}])
任务状态流转
text
todo → inprogress → inreview → done
↘ cancelled
状态报告
markdown
| 任务 | 状态 | 备注 |
|---|
| Bug: 登录 | inprogress | 代理正在调查 |
| Feature: 暗黑模式 |
todo | 就绪 |
活跃中：2 | 已完成：5
监控
CI状态监控
bash
快速检查
scripts/monitor-pr-ci.py 123 -R owner/repo
等待完成
scripts/monitor-pr-ci.py 123 --wait --timeout 600
升级触发条件
- - 代理阻塞超过30分钟
- 超出代理范围的决策
- 安全或破坏性变更问题
反模式
协调者反模式
- - 编写代码而非委派
- 创建没有验收标准的任务
- 分配已阻塞的任务
任务反模式
- - 模糊：修复这个bug
- 无上下文：缺少链接/背景
- 范围蔓延：在任务进行中添加需求
- 过大：应被拆解
附加资源
参考文件
- - references/vibekanban-api.md - 完整MCP工具参考
- references/cos-workflow.md - 详细工作流程步骤
- references/delegation-patterns.md - 双层模式示例
脚本
- - scripts/monitor-pr-ci.py - 高效的CI监控脚本
示例
- - examples/task-templates.md - 完整任务描述模板
