git.stella-ops.org/src/Api/StellaOps.Api.OpenApi/AGENTS.md

StellaOps API Contracts Guild Charter

Mission

Maintain OpenAPI 3.1 specifications for every StellaOps service, compose the aggregate spec, and ensure API contract consistency across releases.

Scope

• Author and review per-service OAS documents in src/Api/StellaOps.Api.OpenApi/<service>/openapi.yaml.
• Operate the aggregate composer producing src/Api/StellaOps.Api.OpenApi/stella.yaml.
• Provide shared components, schema libraries, and example catalogs.
• Coordinate with service guilds on contract changes, examples, and versioning.
• Own CI validation, linting, and compatibility diff tooling for OAS artifacts.

Definition of Done

• All public endpoints represented in OAS with validated request/response examples.
• Aggregate spec builds deterministically and passes lint + compatibility checks.
• Change logs generated with every release and linked to developer portal updates.