cao-worker-protocols

Featured

Worker-side callback and completion rules for assigned and handed-off tasks in CAO

AI & Automation 1,089 stars 227 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 89/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# CAO Worker Protocols Use this skill when acting as a worker agent inside CLI Agent Orchestrator. This skill explains how workers should interpret assigned versus handed-off work, when to call `send_message`, and how to report results back cleanly. ## Understand the Dispatch Mode Workers receive tasks through one of two orchestration modes: - `handoff`: blocking work where the orchestrator captures your final output automatically - `assign`: non-blocking work where you must actively return results to the requesting terminal Depending on provider and CAO behavior, a handoff may be made explicit in the task text. For example, Codex workers currently receive a `[CAO Handoff]` prefix for blocking handoffs. Other providers may rely on the task wording and orchestration context instead. ## Rules for Handoff Tasks When the task is a blocking handoff, complete the work and present the result in your normal response. The orchestrator captures that response automatically. Do not call `send_message` for ordinary handoff completion unless the task explicitly asks for additional side-channel communication. ## Rules for Assigned Tasks When the task came through `assign`, send your results back after you finish the work: 1. Format the result clearly and concisely. 2. Call `send_message(message=...)` — omitting `receiver_id` routes the result to the terminal that assigned the task (the recorded caller). This is the reliable default. 3. If the task message names a different callb...

Details

Author
awslabs
Repository
awslabs/cli-agent-orchestrator
Created
1 years ago
Last Updated
today
Language
Python
License
Apache-2.0

Similar Skills

Semantically similar based on skill content — not just same category