| name | api-v1-contracts |
| description | Use when implementing or reviewing versioned API endpoints, request/response contracts, resources, and integration-facing payloads for this repository. |
API v1 Contracts
Use this skill when the output must be consumed by something other than the current panel page.
Read first
docs/blueprints/development-roadmap.md
docs/engineering/development-best-practices.md
docs/decisions/ADR-0001-laravel-architecture.md
docs/decisions/ADR-0002-multi-tenancy-and-panels.md
Workflow
- Put routes under
api/v1.
- Define validation in Form Requests.
- Define output contracts in API Resources when the shape matters.
- Resolve tenant context server-side.
- Add tests for:
- expected payload shape
- auth or public access behavior
- cross-tenant denial when applicable
Rules
- prefer additive changes to response payloads
- keep naming stable and explicit
- avoid shipping panel-only assumptions into integration contracts
- document breaking behavior with an ADR or explicit note if it cannot be avoided