A pattern reference for governed multi-agent engineering delivery: scoped work packages, handoff queues, isolated execution trees, review checkpoints, and durable merged state.
This repository ships the pattern reference: documentation, templates, and one synthetic worked walkthrough. Executable orchestration is not in scope at v1.
- A pattern reference for a governed multi-agent engineering-delivery workflow.
- Documentation (architecture, operating model, lifecycle, vocabulary, private-vs-public separation) plus four reusable templates plus one synthetic end-to-end walkthrough.
- A supporting repository in a four-repo portfolio. The three flagship repositories named under Adjacent repositories carry their own technical depth.
- Not the exact internal operating system used in any private work. The repo is a public-safe re-derivation of the pattern, not a snapshot of any real run-state.
- Not a deployed platform or runtime. No customer deployment claim.
- Not a managed service or proprietary SaaS.
- Not a generalized multi-tenant agent platform.
- Not a workshop, training course, adoption field-kit, or facilitator artifact.
- Not a flagship proof repository with captured-run evidence.
| Path | Purpose today |
|---|---|
docs/architecture.md |
The seven-component workflow model and lifecycle diagram. |
docs/operating-model.md |
The four-role table, scopes, and handoff rules. |
docs/lifecycle-and-state.md |
The state-transition graph and per-state required artifacts. |
docs/vocabulary.md |
Vocabulary used across the pattern, plus extension guidance for adopters. |
docs/private-vs-public.md |
What stays in an adopter's coordination repository vs what becomes adopter-public. |
templates/work-package-template.md |
A bounded unit-of-work template with the eight required sections. |
templates/handoff-message-template.md |
The handoff-queue message shape. |
templates/return-artifact-template.md |
The worker return-artifact shape. |
templates/review-response-template.md |
The review-response shape and verdict vocabulary. |
examples/oss-library-maintenance/ |
One synthetic end-to-end walkthrough applying the pattern to a fictional open-source library maintenance scenario. |
ROADMAP.md |
What v1 ships, what does NOT ship at v1, and v1.1+ candidates. |
There is nothing to run. To use the pattern: read docs/operating-model.md and docs/lifecycle-and-state.md, then walk through examples/oss-library-maintenance/ for a complete one-cycle illustration.
The three sibling canonical repositories are out-of-scope here. Cross-references are descriptive only; this repository does not import or deploy them.
production-rag-eval-harness— retrieval-quality evaluation (the home for retrieval implementation depth).agent-runtime-observability— governed agent runtime (the home for agent-runtime implementation depth).aws-bedrock-iac-reference— AWS / Bedrock infrastructure-as-code reference (the home for cloud-side architecture depth).