Skip to main content

Ownership Model

AXAG annotations and Semantic Manifests are living artifacts that require clear ownership, maintenance responsibilities, and decision-making authority.

Who Owns What​

ArtifactOwnerReviewerConsumer
AXAG SpecificationStandards BodyCommunityEveryone
AXAG Annotations (per page)Feature TeamPlatform TeamAgent Frameworks
Semantic ManifestPlatform TeamSecurity TeamAgent Runtime
Generated ToolsPlatform TeamFeature TeamAI Agents
Validation RulesPlatform TeamAll TeamsCI/CD Pipeline

Annotation Ownership​

Annotations belong to the team that owns the feature:

  • The shopping cart team owns cart.* annotations
  • The billing team owns billing.* annotations
  • The admin team owns admin.* annotations

Responsibilities​

  • Keep annotations in sync with UI changes
  • Update parameters when form fields change
  • Review risk levels when business logic changes
  • Respond to cross-reference validation failures

Manifest Ownership​

The Semantic Manifest is owned by the platform/API team because:

  • It serves as the contract between UI and agents
  • Changes affect all downstream consumers (tool generation, agent behavior)
  • It requires coordination across feature teams
  • Security review is mandatory for risk level changes

Change Authority​

Who Can Change What​

Change TypeWho Can ProposeWho Approves
New annotationFeature teamPlatform team
Change risk levelFeature or SecuritySecurity team
Add new entityFeature teamArchitecture team
Deprecate intentPlatform teamAll consuming teams
Change safety boundarySecurity teamSecurity + Platform
Schema version bumpStandards bodyGovernance committee

RACI Matrix​

ActivityResponsibleAccountableConsultedInformed
Write annotationsFeature DevFeature LeadPlatformAgent Teams
Review annotationsPlatformPlatform LeadSecurityFeature
Generate manifestPlatformPlatform LeadFeatureAgent Teams
Validate in CIDevOpsPlatform LeadAllAll
Security reviewSecuritySecurity LeadPlatformFeature
Version releasePlatformGovernanceAllAll