Agent Delegation Testing

Verify agent hierarchy, delegation chains, and escalation paths.

When to Use

•After modifying agent hierarchy
•Verifying escalation paths work correctly
•Troubleshooting delegation issues
•CI/CD validation before merge

Quick Reference

bash

# Test all delegation patterns
python3 tests/agents/test_delegation.py .claude/agents/

# Test specific agent delegation
./scripts/test_agent_delegation.sh implementation-specialist

# Visualize delegation tree
./scripts/visualize_delegation.sh

What Gets Tested

Hierarchy levels: Agents delegate to lower levels, escalate to higher levels

Delegation chains: L0 → L1 → L2 → L3 → L4 (proper tree structure)

Circular dependencies: Detect A → B → C → A patterns

Reference validity: All delegates_to/escalates_to targets exist

Level consistency: Level values correct and levels don't skip improperly

Validation Rules

Rule	Example ✅	Wrong ❌
Delegate downward	L2 → L3	L3 → L2
Escalate upward	L3 → L2	L3 → L4
No circles	A → B, A → C	A → B → A
Valid refs	Existing agent	Nonexistent agent

Common Issues

Circular dependency: Agent A → Agent B → Agent A

•Fix: Break circle by restructuring delegation

Skip-level delegation: L2 → L4 (skips L3)

•Fix: Document exception in agent description

Orphaned agent: No other agent delegates to it

•Fix: Add delegation or remove if unused

References

•/agents/delegation-rules.md - Complete delegation guidelines
•.claude/agents/ - All agent configurations
•CLAUDE.md - Hierarchy documentation