Canonical Vocabulary

The AXAG canonical vocabulary defines all reserved attribute names, their types, allowed values, and semantic meaning.

Reserved Attribute Prefix

The prefix axag- is reserved for AXAG annotations. Implementations MUST NOT use this prefix for non-AXAG purposes.

Identity Attributes

Attribute	Type	Description
axag-intent	string	Semantic intent in entity.verb format
axag-entity	string	Domain entity being operated on
axag-action-type	enum	Operation classification
axag-description	string	Human-readable description
axag-operation-id	string	Unique operation identifier

Parameter Attributes

Attribute	Type	Description
axag-required-parameters	string[]	JSON array of required parameter names
axag-optional-parameters	string[]	JSON array of optional parameter names
axag-parameter	string	Parameter name (on input elements)
axag-parameter-type	string	Parameter data type
axag-parameter-required	boolean	Whether the parameter is required
axag-parameter-description	string	Parameter description
axag-parameter-format	string	Expected format (email, date, url, etc.)
axag-parameter-enum	string[]	Allowed values for enum parameters
axag-parameter-min	number	Minimum value
axag-parameter-max	number	Maximum value
axag-parameter-pattern	string	Regex pattern for validation

State Attributes

Attribute	Type	Description
axag-preconditions	string[]	Required state before execution
axag-postconditions	string[]	Guaranteed state after execution
axag-side-effects	string[]	Observable changes beyond primary result

Safety Attributes

Attribute	Type	Description
axag-risk-level	enum	none, low, medium, high, critical
axag-confirmation-required	boolean	Whether explicit confirmation is needed
axag-confirmation-message	string	Message to display for confirmation
axag-approval-required	boolean	Whether multi-party approval is needed
axag-approval-roles	string[]	Roles that can approve
axag-approval-count	number	Number of approvals required
axag-idempotent	boolean	Whether safe to repeat
axag-rate-limit	string	Maximum invocation frequency
axag-cooldown	string	Minimum time between invocations

Scope Attributes

Attribute	Type	Description
axag-scope	string	Operational boundary
axag-tenant-context	string	Tenant identifier context
axag-cross-tenant	boolean	Whether cross-tenant operation is allowed
axag-required-roles	string[]	Roles permitted to invoke
axag-role-escalation	boolean	Whether role escalation is permitted

Visibility Attributes

Attribute	Type	Description
axag-visible	boolean	Whether discoverable by agents
axag-operable	boolean	Whether invocable by agents
axag-operability-reason	string	Why the operation is not operable

Workflow Attributes

Attribute	Type	Description
axag-workflow-id	string	Workflow identifier
axag-workflow-step	number	Step position in workflow
axag-workflow-total-steps	number	Total steps in workflow
axag-workflow-next	string	Intent of next step
axag-workflow-previous	string	Intent of previous step

Versioning Attributes

Attribute	Type	Description
axag-version	string	AXAG specification version
axag-deprecated	boolean	Whether this annotation is deprecated
axag-deprecated-replacement	string	Replacement intent for deprecated operations
axag-since	string	Version when this annotation was introduced

Action Type Values

Value	Description
read	Non-mutating data retrieval
create	Creates a new entity instance
mutate	Modifies an existing entity
delete	Removes an entity
navigate	Changes the view or context without data mutation

Risk Level Values

Value	Description	Typical Actions
none	No risk	Search, browse, read
low	Easily reversible	Add to cart, bookmark
medium	Requires attention	Update profile, change settings
high	Financial or data impact	Process payment, submit application
critical	Irreversible, high impact	Delete account, purge data

Next Steps

• Annotation Primitives
• Required Fields