OpenAPI Development Skill

Context (Input)

• Adding new OpenAPI endpoint factories under src/Shared/Application/OpenApi/Factory/Endpoint/
• Adding/editing request/response/schema factories under src/Shared/Application/OpenApi/Factory/
• Adding/editing processors that transform the generated spec
• Fixing OpenAPI validation errors from:
  • make validate-openapi-spec (Spectral)
  • make openapi-diff
  • make schemathesis-validate

Task (Function)

Develop and maintain OpenAPI specification generation in a way that:

• Keeps code quality thresholds intact (complexity, style, architecture)
• Preserves immutability when working with API Platform OpenAPI models (with*() methods)
• Produces a spec that passes Spectral and stays diff-stable