The ACP spec includes a library of example protocols demonstrating coordination patterns across many domains. Each protocol is a complete, runnable YAML spec.
Two reviewers + one author. Reviewers examine changes, provide feedback, author addresses it. Governance ensures budget limits and heartbeat monitoring.
reviewer : { count : " 2+ " , model_hint : sonnet }
author : { count : 1 , model_hint : haiku }
review : { exit_condition : { state_key : phase , equals : revision } }
revision : { exit_condition : { state_key : phase , equals : done } }
budget : { max_cost : 5.00 }
heartbeat : { dead_after_ms : 60000 , auto_release_claims : true }
Turn-based game with two AI players (or one human, one AI). State machine handles move validation, turn tracking, and game end conditions via a dance file.
white : { count : 1 , agents : 0 } # human-controlled
black : { count : 1 , model_hint : " cerebras/gpt-oss-120b " }
Social deduction game with 6 players. Hidden roles (werewolves, seer, villagers), night/day cycle, freeform discussion, and voting. Demonstrates emergent social behavior.
player : { count : 6 , model_hint : " cerebras/gpt-oss-120b " }
setup : { exit_condition : { event : start } }
night : { exit_condition : { state_key : phase , equals : day } }
day : { exit_condition : { state_key : phase , equals : vote } }
vote : { exit_condition : { state_key : phase , equals : night } }
Protocol Agents Pattern Code Review reviewer + author Turn-based feedback loop Pair Programming navigator + driver Real-time collaboration Refactoring analyst + implementer Analyze → plan → execute Test Generation developer + tester Write code → write tests → verify Bug Triage reporter + investigator + fixer Pipeline with handoffs Architecture Review architect + developers Design → review → iterate Documentation writer + reviewer Draft → review → publish Migration planner + executor + validator Multi-phase with validation
Protocol Players Pattern Chess 2 Turn-based, state machine Werewolf 6 Social deduction, hidden roles Debate 2-4 Argument → rebuttal → judge Negotiation 2 Offer → counter → settle Trivia 3-8 Question → answer → score Diplomacy 3-7 Alliance, betrayal, strategy
Protocol Agents Pattern Literature Review searcher + analyst Gather → synthesize Hypothesis Testing theorist + experimenter Propose → test → conclude Data Analysis collector + analyst + visualizer Pipeline Peer Review author + reviewers Feedback loop Survey Design designer + validator Create → validate → refine
Protocol Agents Pattern Incident Response detector + responder + communicator Triage → fix → report Deployment builder + deployer + monitor Build → deploy → verify Monitoring observer + analyst + alerter Watch → analyze → act Security Audit scanner + reviewer + reporter Scan → review → report Capacity Planning forecaster + planner Predict → allocate
Protocol Agents Pattern Story Writing plotter + writer + editor Plan → write → revise Brainstorming ideators + evaluator Generate → filter → rank Design Review designer + critics Present → critique → iterate Content Calendar strategist + creators Plan → produce → schedule
Protocol Agents Pattern Tutoring tutor + student Teach → test → adapt Exam Generation writer + reviewer Create → review → calibrate Curriculum Design designer + validator Design → validate → sequence Study Group learners + moderator Discuss → quiz → summarize
Protocol Agents Pattern Customer Support triage + specialist Route → resolve → follow up Supply Chain planner + executor Forecast → order → track Legal Review analyst + reviewer Review → flag → recommend Financial Audit collector + auditor Gather → verify → report HR Onboarding coordinator + trainer Plan → train → verify Project Planning planner + estimator + tracker Plan → estimate → track
# Clone the protocol from the marketplace
wgl marketplace install werewolf
--brood=demos/werewolf/brood.yaml \
See the Demos Guide for step-by-step instructions on running the chess and werewolf demos.
Each protocol has a detailed page with role diagrams, phase flow charts, and run results on the ACP standalone docs site .