Orchestration
Multi-Agent Patterns
Coordination primitives for orchestrating multiple agents across product requirements review workflows — handoffs, parallel execution, routing, and inter-agent communication.
Identity
Agent Cards
Individual agent identity cards showing name, role, current status, and active task. Cards reflect the agent's operational state in real time.
Operational table
| Agent | Status | Task | Progress | Confidence | Cost | Updated |
|---|---|---|---|---|---|---|
Source Collector Gather project artifacts | WorkingWorking | Collecting delivery readiness artifacts | 91% | $0.14 | 18s ago | |
Requirements Mapper Map requirements to controls | HandoffHandoff | Waiting for source packet before final coverage mapping | 82% | $0.09 | 42s ago | |
Document Drafter Author project brief sections | IdleIdle | No drafting until mapped requirements are confirmed | n/a | $0.00 | 2m ago |
| Element | Details |
|---|---|
| Card layout | Responsive grid, each card with avatar, name, role, and state-specific details |
| Active state | Current task description and progress info |
| Idle state | Role-specific waiting note ("Waiting for a source packet to map") |
| Error state | Alert icon, error message, retry action button |
Orchestration
Handoff Flow
Sequential task handoff between agents. Each step produces output that becomes input for the next agent in the pipeline.
Export workflow coverage packet
DraftOwnership transfer for a requirement gap that must be resolved before the review report can be finalized.
- Payload
- Requirement coverage delta for Export workflow, including missing JSON export support.
- Source basis
- Project brief v3, Launch Policy v2, Support readiness checklist
- Receiver action
- Confirm whether Document Drafter should update implementation notes section 6.1.3.
- Recovery
- Rejecting the packet keeps the run blocked and asks Source Collector to gather more evidence.
| Element | Details |
|---|---|
| Step cards | Responsive step cards with step number, task label, and assigned agent |
| Connectors | Arrow icons between steps, opacity reflects whether handoff has occurred |
| Pending state | First step highlighted, remaining steps gently muted |
| Complete state | All steps show tick icon with subtle background tint |
Concurrency
Parallel Agents
Multiple agents executing independent tasks simultaneously. Each agent reports individual progress toward its own objective.
| Element | Details |
|---|---|
| Agent rows | Stacked cards with avatar, name, task description, and status indicator |
| Progress bars | Animated fill to individual target width, monochrome foreground tint |
| Running state | Pulsing dot, active task label, percentage complete |
| Complete state | Tick icon, results summary replaces task description, bar at 100% |
Dispatch
Agent Routing
Routing incoming tasks to the most appropriate agent based on task type analysis or manual selection by the workflow owner.
| Element | Details |
|---|---|
| Task card | Shows incoming task with detected type classification |
| Auto routing | Best-match agent highlighted, others dimmed at 40% opacity |
| Manual routing | All agents interactive, click to select destination |
| Selection indicator | Arrow icon with context label ("Best match" or "Selected") |
Collaboration
Agent Communication
Inter-agent information exchange via direct messaging or a shared context workspace. Both patterns create auditable communication records.
| Element | Details |
|---|---|
| Direct messages | Chat-style thread between two agents with sender/receiver labels |
| Message alignment | Alternating left/right layout based on sender, subtle background tint |
| Shared context | List of contributed items with agent attribution, type badge, and timestamp |
| Context types | Artifact, Finding, Draft, Analysis, Assessment — shown as muted badges |