agent-coordination

Agent Coordination Skill

This skill provides patterns for invoking the Automatasaurus agents and managing bidirectional context flow.

Coordination Modes

Automatasaurus supports two modes for coordinating agent work:

Mode	Mechanism	Communication	Best For
Subagents (default)	Task tool	Report to orchestrator only	Single-role tasks, linear workflows
Agent Teams (experimental)	Team creation	Peer-to-peer messaging + shared tasks	Multi-role reviews, real-time collaboration

Decision criteria:

• Use subagents when tasks are independent and don't benefit from real-time coordination
• Use teams when agents should share findings and coordinate in real-time (e.g., review cycles)
• Check teamPreferForReviews and teamPreferForImplementation in settings for project defaults
• Always have a fallback to subagents — teams are experimental

For detailed team patterns, load the team-coordination skill.

Available Agents

Agent	Purpose	When to Use
developer	Implements issues, creates PRs	When code needs to be written
architect	Technical reviews, analysis	For PR reviews, discovery reviews, stuck issues
designer	UI/UX reviews, design specs	For PR reviews, discovery reviews, design specs
researcher	Deep research, technology evaluation	When any agent needs thorough research on a topic
tester	Testing, verification	For PR verification, running tests

---

Bidirectional Context Flow

Sub-agents start with fresh context (no conversation history). Use briefing and report files to communicate context and capture results.

Orchestration Folder Structure

orchestration/
├── discovery/
│   └── {date}-{feature-slug}/
│       ├── BRIEFING-architect-review.md
│       ├── REPORT-architect-review.md
│       └── ...
├── planning/
│   └── {date}-{plan-name}/
│       └── ...
└── issues/
    └── {issue-number}-{slug}/
        ├── BRIEFING-design-specs.md
        ├── REPORT-design-specs.md
        ├── BRIEFING-implement.md
        ├── REPORT-implement.md
        ├── BRIEFING-architect-review.md
        ├── REPORT-architect-review.md
        ├── BRIEFING-designer-review.md
        ├── REPORT-designer-review.md
        ├── BRIEFING-test.md
        └── REPORT-test.md