Agent Primitives
Purpose
Agent Primitives (APM) provides foundational building blocks for constructing AI agents and automated workflows at Calab.ai. The APM registry defines reusable packages and primitives — agents, instructions, prompts, skills, and hooks — that can be installed into any consumer repository via gh calab apm.
Onboarding
New to APM? Start with the APM Onboarding hub — it covers the consumer quick start, primitive and package authoring, publishing, install/upgrade flows, and troubleshooting.
| Page | Use it when… |
|---|---|
| Onboarding overview | You want the 5-minute tour and a quick start. |
| Concepts | You need the shared vocabulary (primitives, packages, lockfile, provenance). |
| Authoring primitives | You are creating an agent, instructions, prompt, skill, hook, or init primitive. |
| Authoring packages | You are bundling primitives into a versioned package. |
| Publishing | You are releasing a primitive or package into calab-ai/apm-registry. |
| Installing | You are adding APM dependencies to a consumer repo. |
| Upgrading | You need to bump versions, resolve drift, or sync a workspace. |
| Troubleshooting | A gh calab command failed and you need the exit-code map. |
| Marketplace | You want to browse the live portal or in-handbook snapshot. |
Marketplace
The APM Marketplace is the staff-facing portal for all released packages and primitives. It is generated from catalog data published by calab-ai/apm-registry — the handbook is a consumer, not the source of truth.
| Section | Description |
|---|---|
| All packages & primitives | Index of everything in the current catalog |
| calab-workspace-base | Base workspace package for consumer repos |
| calab-org-agents | Org-level Copilot agent package |
Architecture
The APM architecture is documented in:
Key Decisions
| Decision | Topic |
|---|---|
| Decision 10 | Rename agent-primitives → 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 |
| Decision 15 | Defer separate APM registry service |
Current Status
- Status: Active
- Owner: [Name/TBD]
- GitHub Review Team:
@calab-ai/guild-delivery - Entra Group:
sg-guild-delivery
Related Resources
- calab-ai/apm-registry — source of truth for packages and primitives
- NeuralOps
- Technology Guild
Version: 1.2 Last Updated: 2026-04-27 Maintained By: Delivery Guild