fetcher-wow-cqrs

name	fetcher-wow-cqrs
description	Use when creating Wow DDD and CQRS clients with Fetcher, including CommandClient, SnapshotQueryClient, EventStreamQueryClient, aggregate load clients, QueryClientFactory, command stages and headers, query DSL conditions, generated clients, and pagination types.

fetcher-wow-cqrs

Use This Skill When

• The task mentions Wow, CQRS, DDD, commands, queries, aggregates, snapshots, or event streams.
• The task needs command sending, command stage waiting, or command headers.
• The task needs snapshot queries, event-stream queries, aggregate state loading, or query factories.
• The task needs the Wow query DSL, pagination, projections, sorting, or generated client patterns.

Workflow

1. Start from aggregate metadata: service, bounded context, aggregate name, tenant, and owner attribution.
2. Use CommandClient for command writes and query clients for read-side access; keep those flows separate.
3. Use QueryClientFactory when multiple query clients share the same metadata and attribution path spec.
4. Build query conditions with the DSL instead of ad hoc JSON objects.
5. Load references/api.md for constructors, client methods, command stages, query DSL operators, key types, generated clients, and complete flows.

Key Practices

• Keep command requests explicit about aggregate identity and expected command result behavior.
• Use generated clients when OpenAPI metadata is the source of truth.
• Route generation-time questions to fetcher-openapi-generator; keep this skill focused on runtime Wow clients and DSL usage.

References

• references/api.md: Detailed package API, examples, and edge-case guidance. Load it only when the task needs imports, constructors, command APIs, query clients, aggregate load clients, factory setup, query DSL operators, key types, generated clients, and end-to-end examples.

Related Skills

• $fetcher-openapi-generator: Use to generate Wow CQRS clients from OpenAPI specs.
• $fetcher-viewer-components: Use for table and filter UIs backed by Wow queries.
• $fetcher-react-hooks: Use for React Wow query hooks.