1.8 KiB
Task NNN: Feature Name
Objective
Describe the operational outcome.
Background
Summarize relevant current behavior and dependencies.
Scope
List exactly what is included.
API
Define every route, request, response, permission, and status code.
Permissions
Define capabilities and role assignments.
Domain Rules
List invariants and lifecycle rules.
Architecture
Preserve:
Router -> Service -> Repository -> PostgreSQL
Database and Migration
Define schema changes, constraints, indexes, migration order, and downgrade behavior.
Events and History
Define immutable events, sequence, actor, timestamp, and structured payload.
Models and Validation
Define UUID, time, enum, normalization, length, and JSON requirements.
Repository Requirements
Define focused query and locking behavior. Avoid N+1 queries and generic CRUD.
Service Requirements
Define validation, workflow, transaction boundaries, and domain exceptions.
Router Requirements
Define dependencies, exception mapping, and route-count constraints.
Error Behaviour
Define 401, 403, 404, 409, 422, and any additional statuses.
Concurrency and Atomicity
Describe races and database enforcement.
Tests
Cover authorization, domain behavior, rollback, constraints, migrations, regressions, routing, and architecture audits.
Validation
Run compilation, shell validation, focused and regression tests, migration lifecycle tests, disposable baseline, architecture audits, route audit, and git diff --check.
Documentation
List required roadmap, release, API, or operator documentation.
Explicitly Out of Scope
List adjacent features that must not be added.
Completion Report
Report files, migration, routes, permissions, tests, validation, limitations, and final git status --short.
Do not commit. Do not push.