OpenAPI Spec

Produce and maintain OpenAPI (Swagger) specifications so APIs are documented and tooling can generate clients, mocks, or validation.

When to Activate

• User asks for "OpenAPI", "Swagger", or "API spec"
• Documenting a REST API for consumers or codegen
• Adding new endpoints or changing request/response shapes
• Generating client SDKs or mock servers from the spec

Work Process