Agent Coordination

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