Files
Yuzviak 6ff14a1a7d chore: import .claude command skills, CLAUDE.md, .gitignore, next_steps.md
- Vendor local .claude/ command skills (autopilot, plan, implement, etc.)
- Add CLAUDE.md pointing slash commands to .claude/commands/*/SKILL.md
- Untrack docs-Lokal/ and ignore .planning/ for local-only planning docs
- Include next_steps.md pulled from upstream

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-16 21:39:43 +03:00

16 lines
616 B
Plaintext

---
description: "OpenAPI/Swagger API documentation standards — applied when editing API spec files"
globs: ["**/openapi*", "**/swagger*"]
alwaysApply: false
---
# OpenAPI
- Use OpenAPI 3.0+ specification
- Define reusable schemas in `components/schemas`; reference with `$ref`
- Include `description` for every endpoint, parameter, and schema property
- Define `responses` for at least 200, 400, 401, 404, 500
- Use `tags` to group endpoints by domain
- Include `examples` for request/response bodies
- Version the API in the path (`/api/v1/`) or via header
- Use `operationId` for code generation compatibility