Overview
This workspace captures the solution-level view of the Agent Primitives platform.
Scope
The workspace focuses on the runtime and operating model needed to:
- author reusable agent workflows
- publish and execute automation patterns
- persist metadata and evaluation outcomes
- connect the platform to handbook and repository context where needed
Relationship To The Enterprise Workspace
The enterprise workspace defines where Agent Primitives sits in the wider Calab.ai landscape.
This solution workspace adds the next level of C4 detail by showing the main containers and one key dynamic flow.
APM Flows
Sequence diagrams for the four primary APM operational flows are in 02-apm-sequence-diagrams.md:
- Release to marketplace (apm-registry → catalog → handbook + gh calab)
- Consumer install and update (gh calab apm install → apm.yml + apm.lock.yaml + generated files)
- Upstream ingestion (gh calab apm import → governed vendoring into apm-registry)
- .github-private generated distribution (GA release → org Copilot agent sync)
Architecture Decision Records
| Decision | Title |
|---|---|
| Decision 10 | Migrate agent-primitives repository to apm-registry |
| Decision 11 | CLI direction — gh-calab owns gh calab apm |
| Decision 12 | Manifest and lockfile tag-ref model |
| Decision 13 | Handbook as consumer of generated catalog data |
| Decision 14 | .github-private as generated distribution surface |
| Decision 15 | Defer separate APM registry service |