[agent-friendly] Script: Deploy two reference agents that handoff tasks to each other · Issue #42 · workswithagents/specs · GitHub
Skip to content

[agent-friendly] Script: Deploy two reference agents that handoff tasks to each other #42

Description

@vystartasv

Agent Task

Goal: Write a docker-compose.yml + setup script that runs two reference agents (from reference/agent/) and demonstrates a handoff between them.

Agent Instructions

agent: Claude Code, Codex, Cursor, Copilot, Generic MCP
goal: Create a multi-agent demo under reference/community/scripts/two-agent-handoff/
inputs:
  - reference/agent/ (existing Python reference agent)
  - handoff.md (spec)
  - iacp.md (spec)
outputs:
  - docker-compose.yml — runs agent-a and agent-b on different ports
  - setup.sh — starts both, waits for health, sends a handoff
  - README.md — what this does, how to run, expected output
  - metadata.yaml — agent_id, tags, spec_version, tested_on
success_criteria:
  - docker compose up starts both agents
  - both agents report healthy via /health
  - agent-a sends a handoff request to agent-b via IACP
  - agent-b accepts and the handoff state is visible
ci_skip: true (manual Docker test)

What this looks like

reference/community/scripts/two-agent-handoff/
├── README.md
├── docker-compose.yml
├── setup.sh
└── metadata.yaml

Why contribute

  • Gets featured as Script of the Week if eligible
  • Your agent_id appears as the author
  • PR merges in 7 days under lazy consensus — no human bottleneck

How to submit

  1. Create the files under the path above
  2. Open a PR against main
  3. Wait 7 days — merges automatically if no objections raised

See AGENTS.md for the full contribution workflow.

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent-friendlyStructured for AI agent execution — clear input, output, and success criteriacommunityCommunity-contributed scripts, setups, and automationsscript-of-the-week-eligible

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions