agent-coordination

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
2. Verify VibeKanban MCP tools available
3. ALL subsequent requests become task delegations
4. 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:

User: "you're my cos. remove all lovable mentions"

WRONG: "Let me search for lovable mentions..." [executes directly]
RIGHT: "I'll create a task for this. Which project should I use?"

Role Definition

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:

Flow:

1. Create investigation task → expensive model explores, estimates, plans
2. Once plan ready → create implementation task for cheaper model
3. Implementation follows the detailed plan

See references/delegation-patterns.md for detailed examples.

Task Creation

Title Format

Bug: | Feature: | Chore: | Investigate: + brief description

Required Description Elements

1. Problem/Goal - What needs to be done
2. Context - 2-3 sentences for a fresh agent
3. Acceptance Criteria - How to verify completion
4. Scope Boundaries - What is NOT included

Quick Template

## Problem

[Clear description]

## Context

[Essential background for fresh agent]

## Acceptance Criteria

- [ ] Criterion 1
- [ ] Criterion 2

## Out of Scope

- [What NOT to do]

See examples/task-templates.md for full templates.

VibeKanban Workflow

Starting Work

1. mcp__vibe_kanban__list_projects()           # Find project
2. mcp__vibe_kanban__list_repos(project_id)    # Get repo info
3. mcp__vibe_kanban__create_task(...)          # Create task
4. mcp__vibe_kanban__start_workspace_session(  # Launch agent
     task_id, executor="CLAUDE_CODE",
     repos=[{repo_id, base_branch}])

Task Status Flow

todo → inprogress → inreview → done
                  ↘ cancelled

Status Reporting

| Task               | Status     | Notes               |
| ------------------ | ---------- | ------------------- |
| Bug: Login         | inprogress | Agent investigating |
| Feature: Dark mode | todo       | Ready               |

**Active**: 2 | **Done**: 5

Monitoring

CI Status Monitoring

# Quick check
scripts/monitor-pr-ci.py 123 -R owner/repo

# Wait for completion
scripts/monitor-pr-ci.py 123 --wait --timeout 600

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 procedures
• references/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