Add API-first development methodology to project statutes

The OpenAPI spec is the single source of truth for the REST API
contract. Endpoints and schemas must be defined in the spec before
writing implementation code.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-04 22:08:19 +01:00
parent 747ed18945
commit b8421274b4

View File

@@ -16,6 +16,7 @@ These are the non-negotiable principles of this project. Every decision — arch
### Methodology ### Methodology
- Follow Research → Spec → Test → Implement → Review. No shortcuts. - Follow Research → Spec → Test → Implement → Review. No shortcuts.
- API-first development: the OpenAPI spec (`backend/src/main/resources/openapi/api.yaml`) is the single source of truth for the REST API contract. Define endpoints and schemas in the spec first, then generate backend interfaces and frontend types before writing any implementation code.
- Never write implementation code without a specification. - Never write implementation code without a specification.
- Always write tests before implementation (TDD). Red → Green → Refactor. - Always write tests before implementation (TDD). Red → Green → Refactor.
- Refactoring is permitted freely as long as it does not alter the fundamental architecture. - Refactoring is permitted freely as long as it does not alter the fundamental architecture.