{Use Case Name}

Field	Value
Feature	{feature}
Status	Active / Deprecated
Risk Level	Low / Medium / High
Last updated

---

Summary

---

Command or Query

Type	Name	Input	Output	Idempotency
Command / Query	{Verb}{Aggregate}Command			Yes / No

Structural validation

Rules enforced in validators, not aggregate invariants.

---

Domain Behavior

Describe aggregate method(s) invoked and invariants enforced. Reference terms from the feature README in the same folder.

---

Exceptions

Exception	When	HTTP status
{ExceptionName}		404 / 409 / 422

---

HTTP Endpoint

Method	Path	Auth	Rate limit	Idempotency-Key
POST	/api/v1/...	RequireAuthenticatedUser	authenticated-api	Yes / No

---

Persistence (if schema changes)

Change	Migration strategy
	Expand

---

UI

See docs/ui/{app}/pages/{page}.md when the project uses page composition docs.

Operation-level notes only: loading trigger, empty state source, error mapping. Route, screen states, and mutations belong in the page doc.

---

Out of Scope

Explicit exclusions to prevent scope creep.

---

Test Specification

See {use-case}.tests.md. Write and update the test spec in the same PR as tests and behavior changes.