Skip to content

adr-declarative-agent-command-registry

Decision

Promote declarative-agent-command-registry to global core pattern following Reference Architecture ratification.

Context

  • Source: governance-flow
  • Pattern: declarative-agent-command-registry
  • Promotion Recommendation: recommendation-declarative-agent-command-registry
  • Scope Classification: global
  • Scope Classification Artifact: pattern-scope-classification

Externalizes agent task specifications and skills into declarative TOML manifests to standardize how capabilities are defined, shared, and triggered across workspaces.

Scope

Applicability: Applies across all agent tasks, planning commands, and continuous architecture skill definitions.

Global pattern for externalizing agent command contracts and capabilities into repository manifests.

Consequences

Governance

Formalizes declarative manifests as the authoritative contract for agent skills, eliminating divergent CLI command structures.

Execution

Agent executors load task specifications uniformly from declarative manifests rather than bespoke script invocations.

System Behaviour

Provides deterministic skill invocation and validation for both autonomous agents and developer tooling.

Evidence Summary

Promotion Evidence

Ratified Reference Architecture in ArchGov and implemented command manifests in .agents/commands/.

Promotion Criteria

Satisfies governance maturity and ratified reference architecture criteria.

Governance Risks

None identified; ongoing alignment ensures standardized schema consumption across agent runtimes.

Traceability

Pattern Proposal

declarative-agent-command-registry

Scope Classification

Artifact: pattern-scope-classification

Classification: global

Promotion Recommendation

recommendation-declarative-agent-command-registry

Promotion Decision

promotion-decision-declarative-agent-command-registry

Next Step

  • Submit ADR to Architecture Forum for formal institutionalisation
  • Generate global pattern record in knowledge/global/patterns/