agent-coordination

TEMPLATE: This skill uses {{PLACEHOLDER}} tokens. Replace with your project values before use.

Purpose

Guide correct agent assignment, blocker escalation, and delivery coordination following the TDM role boundaries.

When This Skill Applies

• Assigning work to specialist agents
• Managing blockers across agents
• Coordinating multi-agent workflows
• Escalating issues to ARCHitect/POPM
• Verifying pre-implementation gate
• Updating ticket system with evidence

Stop-the-Line Conditions

FORBIDDEN Patterns

# FORBIDDEN: Wrong agent assignment
Database work -> BE Developer    # WRONG: Use Data Engineer!
Security validation -> QAS       # WRONG: Use Security Engineer!
Documentation -> BE Developer    # WRONG: Use Tech Writer!

# FORBIDDEN: Skipping pre-implementation gate
Start coding before BSA spec    # Must have acceptance criteria first

# FORBIDDEN: Unresolved blockers >4 hours
Blocker exists but not escalated  # Escalate within 1 hour

CORRECT Patterns

# CORRECT: Right agent for the job
Database work -> Data Engineer
Security validation -> Security Engineer
Documentation -> Tech Writer
Planning/Specs -> BSA
Architecture review -> System Architect
API implementation -> BE Developer
UI implementation -> FE Developer
Testing -> QAS
PR/Release -> RTE

Agent Assignment Matrix (MANDATORY)

Work Type	Correct Agent	Never Use
Database/Migrations	Data Engineer	BE Developer
Security/RLS	Security Engineer	QAS
Documentation	Tech Writer	BE/FE Developer
Specs/Planning	BSA	Any implementation
Architecture	System Architect	Direct to developer
API Routes	BE Developer	FE Developer
UI Components	FE Developer	BE Developer
Testing/QA	QAS	Implementation team
PR/Releases	RTE	Developers

Reference: docs/workflow/TDM_AGENT_ASSIGNMENT_MATRIX.md

Blocker Escalation Protocol

When to Escalate

Condition	Escalate To	Deadline
Blocker > 1 hour	TDM	Immediately
Blocker > 4 hours	ARCHitect	Urgent
Architecture ambiguity	ARCHitect	Before work
Cross-team dependency	TDM + POPM	Same day
Security concern	SecEng	Immediately

Escalation Template

**Blocker Escalation**

**Ticket**: {{TICKET_PREFIX}}-XXX
**Blocked Since**: [timestamp]
**Agent**: [which specialist is blocked]

**Issue**:
[Clear description of what's blocking progress]

**Attempts Made**:
1. [What was tried]
2. [What was tried]

**Request**:
[Specific ask - decision needed, resource needed, etc.]

Pre-Implementation Gate

MANDATORY before any implementation work:

1. BSA creates spec with:
   - [ ] Clear acceptance criteria
   - [ ] Pattern references for execution
   - [ ] Success validation command

2. System Architect reviews:
   - [ ] Pattern compliance
   - [ ] RLS requirements (if database)
   - [ ] Security implications

3. THEN implementation can begin

Evidence Attachment

All work must include evidence in the ticket system:

**Implementation Evidence**

**Agent**: [which specialist]
**Ticket**: {{TICKET_PREFIX}}-XXX

**Work Completed**:
- [x] Task 1
- [x] Task 2

**Validation**:
{{CI_VALIDATE_COMMAND}}
# All checks passed

**Next Steps**: [if any]

TDM Boundaries

TDM Does

• Track delivery progress
• Update tickets
• Escalate blockers
• Attach evidence
• React to issues

TDM Does NOT

• Orchestrate feature work (ARCHitect's job)
• Run CI/CD validation (specialists' job)
• Execute technical work (specialists' job)
• Proactively assign features (ARCHitect's job)

Authoritative References

• Agent Assignment Matrix: docs/workflow/TDM_AGENT_ASSIGNMENT_MATRIX.md
• Agent Workflow SOP: docs/sop/AGENT_WORKFLOW_SOP.md
• CONTRIBUTING.md: Workflow requirements
• Linear SOP skill: Evidence attachment templates