Status
Accepted
Context
The existing repository calab-ai/agent-primitives has grown beyond its original scope of storing raw primitive files. It now owns or is expected to own:
- agent primitive source files
- APM package definitions and metadata
- release tag conventions and catalog generation
- marketplace feed data consumed by
calab-handbook - policy schemas and install resolution data
The name agent-primitives describes only one part of this expanded role. A repository named apm-registry better communicates the canonical APM install source purpose: it is the governed source for all APM package declarations, agent primitives, schemas, and generated catalog artifacts.
Two alternative names were considered:
agent-primitives— too narrow; implies only raw primitive files, not the full package registry role.agent-registry— narrower than required; implies only agents, not the broader APM package model that includes workspace base packages and other non-agent packages.
Decision
The canonical target name for the APM source-of-truth repository is calab-ai/apm-registry.
The existing calab-ai/agent-primitives repository should be migrated or renamed to apm-registry rather than creating a parallel second repository. All architecture documentation, ADR references, sequence diagrams, and CI workflows should use apm-registry as the authoritative name going forward.
Consequences
- Architecture documentation and sequence diagrams reference
apm-registryas the canonical source. - Any existing references to
agent-primitivesin handbook, CI pipelines, or CLI code will need to be updated on or before the rename. - Teams consuming the existing repo via git remotes or direct URL references must update their configurations at migration time.
- The rename is a breaking change for any tooling hard-coded to the old repository name; a migration guide should accompany the rename.
- Once renamed,
agent-primitivesmust not be repurposed as a different repository to avoid namespace confusion.