agent-patterns · diff
v1.0.0 to v1.0.0
40 added, 21 removed. Audit A to A.
---
name: agent-patterns
- description: |
- Execute this skill should be used when the user asks about "SPAWN REQUEST format", "agent reports", "agent coordination", "parallel agents", "report format", "agent communication", or needs to understand how agents coordinate within the sprint system. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.
+ description: "Format SPAWN REQUEST messages to launch parallel agents, generate structured agent status reports, and define communication protocols within the sprint system. Use when the user needs to coordinate multiple agents, format spawn requests, produce agent reports, or establish inter-agent communication patterns."
allowed-tools: Read
version: 1.0.0
author: Damien Laine <damien.laine@gmail.com>
license: MIT
---
# Agent Patterns
- ## Overview
+ Coordinate multi-agent workflows using structured communication protocols. Covers spawn requests, status reports, and inter-agent messaging within the sprint system.
- This skill provides automated assistance for the described functionality.
+ ## Spawn Request Format
- ## Prerequisites
+ When launching a parallel agent, use this structure:
- - Appropriate file access permissions
- - Required dependencies installed
+ ```markdown
+ ## SPAWN REQUEST
+ - **Agent ID**: <unique-id>
+ - **Role**: <role-name>
+ - **Task**: <one-line description>
+ - **Context**: <relevant files or state>
+ - **Expected Output**: <deliverable format>
+ - **Timeout**: <max duration>
+ ```
- ## Instructions
+ ## Agent Report Format
- 1. Invoke this skill when the trigger conditions are met
- 2. Provide necessary context and parameters
- 3. Review the generated output
- 4. Apply modifications as needed
+ Each agent reports back using:
- ## Output
+ ```markdown
+ ## AGENT REPORT
+ - **Agent ID**: <id>
+ - **Status**: completed | failed | blocked
+ - **Summary**: <one-line result>
+ - **Output**: <deliverable or file path>
+ - **Issues**: <blockers or warnings, if any>
+ - **Duration**: <time taken>
+ ```
- The skill produces structured output relevant to the task.
+ ## Coordination Workflow
- ## Error Handling
+ 1. **Define tasks** — break work into independent units suitable for parallel execution
+ 2. **Spawn agents** — send SPAWN REQUEST for each task with clear context
+ 3. **Monitor status** — track agent reports as they complete
+ 4. **Handle failures** — retry failed agents or reassign blocked tasks
+ 5. **Merge results** — combine agent outputs into final deliverable, resolving conflicts
- See `{baseDir}/references/errors.md` for comprehensive error handling.
+ ## Communication Rules
- ## Examples
+ - Agents communicate through structured reports, not free-form text
+ - Each message includes agent ID for traceability
+ - Blocked agents must report immediately rather than waiting silently
+ - The coordinator agent reviews all reports before merging
- See `{baseDir}/references/examples.md` for detailed examples.
+ ## Error Handling
- ## Resources
+ See `references/errors.md` for common failure modes and recovery steps.
- - Project documentation
- - Related skills and commands
+ ## Examples
+
+ See `references/examples.md` for complete spawn-and-report workflows.