---

name: sea-flow-annotations description: Enforce Flow-only CQRS tagging and recommended metadata.

SEA™ Flow annotation contract

Mandatory

Every Flow includes:

Copy@cqrs { "kind": "command" }

Recommended templates

Command:

Copy@cqrs { "kind": "command" }
@tx { "transactional": true }
@idempotency { "enabled": true, "key": "header:X-Idempotency-Key" }

Event:

Copy@cqrs { "kind": "event" }
@outbox { "mode": "required" }

Query:

Copy@cqrs { "kind": "query" }
@read_model { "name": "CustomerSummary" }

Rules

• JSON must be valid
• Use nested JSON only