Controlled vocabulary

CRD glossary

Concise definitions for the terms used throughout Capability Documentation. The specification remains authoritative where more detail or conformance language is required.

Capability Documentation

The open, technology- and implementation-agnostic framework through which people, agents, applications, and developers can understand, use, build, compose, and operate capabilities.

Capability MLE

The smallest complete, contextually meaningful ability that produces a meaningful outcome.

Capability Requirements Document (CRD)

The canonical technology- and implementation-agnostic requirement specification for one Capability MLE.

Interaction Contract MLE

The smallest contextually meaningful executable behaviour: actor, command, relevant state, policies, transition, result, and effects.

Communication MLE

The smallest contextually meaningful communication unit whose intended meaning should stay consistent across channels, interfaces, actors, and languages. Owned by the capability whose trigger produces it; realized through a canonical-meaning → channel-realization → language-realization chain rather than a single fixed wording.

Realization

A software, agent, human-operated, or combined implementation of a capability or one of its interaction contracts.

Execution mode

A required declaration on every realization stating what controls the capability flow at runtime: software-primary, agent-primary-using-software, software-primary-calling-agents, or unknown. A separate axis from a realization's kind or provenance — it answers who is in control while it runs, not how it was built.

Agent-built software

Implementation provenance, not an execution mode: it records that a realization's implementation was constructed by an agent, not what controls that implementation at runtime. An agent-built implementation can itself run under any execution mode, including one where an agent still directly controls the flow.

Operational Capability Documentation

Realization-specific documentation for a particular service or system.

Rule or invariant

A condition that must remain true for the capability to retain its intended meaning and correctness.

Example

Illustrative content that explains a requirement but does not create a universal requirement by itself.

Implementation choice

A realization-specific decision that is not part of the reusable capability requirement.

Operational constraint

A limitation or condition belonging to a particular operating environment or realization.

Unknown or unresolved

Information that is not established by current evidence and must not be silently invented or promoted into a requirement.

Skill

An agentic realization package that may realize one capability or bundle several capabilities.

Tool

An executable primitive that may support many skills and capabilities. A tool is not automatically a capability because it may lack complete purpose context.

Minimum Logical Element (MLE)

The smallest bundled unit that still retains logical sense and context.