v4.0.0

.claude/commands/coreex-adapter.md

@@ -0,0 +1,14 @@
+---
+description: "Create or modify a CoreEx Infrastructure-layer adapter (anti-corruption layer). USE FOR: new adapter interface in Application/Adapters/{ExternalDomain}/, new adapter implementation in Infrastructure/Adapters/{ExternalDomain}/, new typed HTTP client in Infrastructure/Clients/{ExternalDomain}/, event-driven sync/replication adapter (IXxxSyncAdapter), unit tests for HTTP clients with MockHttpClientFactory. DO NOT USE FOR: repositories within the same domain (use coreex-repository), application services that call adapters (use coreex-app-service), event subscriber hosts that drive sync adapters (see coreex-event-subscribers.instructions.md)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-adapter/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-aggregate.md

@@ -0,0 +1,14 @@
+---
+description: "Add or modify a DDD domain object in a CoreEx Domain layer. USE FOR: new aggregate root (Aggregate<TId,TSelf>), new child entity (Entity<TId,TSelf>) owned by an aggregate, new value object (sealed record), adding mutation methods, PersistenceState-aware factory methods, mutation guards (OnCheckCanMutate/OnMutate). Interviews the developer to determine which of the three (aggregate root / entity / value object) applies, then follows the appropriate pattern. DO NOT USE FOR: CRUD-oriented domains with no Domain layer (use coreex-app-service directly against repositories), Application-layer mappers between aggregate and contract (see coreex-application-services.instructions.md), Infrastructure persistence of aggregates (use coreex-repository)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-aggregate/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-api-e2e.md

@@ -0,0 +1,14 @@
+---
+description: "Create a complete new entity with CRUD API endpoints end-to-end in a single guided workflow: DTO contract, database migration, EF Core repository, validator (+ unit tests), optional policy guard (+ unit tests), application service, API endpoint, and integration tests. USE FOR: adding a brand-new entity to an existing CoreEx solution where the full stack — from database table to HTTP endpoint — is needed. DO NOT USE FOR: modifying an existing entity or endpoint (use the targeted L1 skill directly), read-only façade entities backed by an external adapter with no local table (use individual L1 skills), or any partial-stack additions."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-api-e2e/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-api.md

@@ -0,0 +1,14 @@
+---
+description: "Add or modify a CoreEx API controller (or Minimal API endpoint) in an *.Api host. USE FOR: scaffolding the MVC controller pair (XxxController + XxxReadController), GET/query/schema endpoints, POST create, PUT + PATCH full-entity update, DELETE, and custom business-action endpoints. Covers both exception-based and Result<T> service styles, and Minimal API as an alternative to MVC. DO NOT USE FOR: Api host setup / Program.cs (use coreex-scaffold), application services (use coreex-app-service), API integration tests (use coreex-test-api)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-api/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-app-service.md

@@ -0,0 +1,14 @@
+---
+description: "Create or modify a CoreEx Application-layer service. USE FOR: new service class (exception-based or Result<T>), adding CRUD/business operations, CQRS read service (XxxReadService), adapter interface in Application/Adapters/, policy class in Application/Policies/, application-level mapper (Domain → Contract). DO NOT USE FOR: Infrastructure repositories (use coreex-repository), validators (use coreex-validator), controller endpoints (use coreex-api)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-app-service/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-contract.md

@@ -0,0 +1,14 @@
+---
+description: "Create or modify a hand-authored contract (DTO/entity) in a CoreEx domain. USE FOR: new root entity contract, new subordinate/request contract, modifying an existing contract (add property, add interface, wire ref-data), extracting a shared base class. DO NOT USE FOR: reference-data contracts (generated via coreex-refdata / *.CodeGen), Infrastructure persistence models (generated by *.Database CodeGen)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-contract/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-db-migration.md

@@ -0,0 +1,14 @@
+---
+description: "Add or change a database table for a CoreEx domain. USE FOR: new transactional table, new reference-data table, altering an existing table (columns, indexes, constraints), or any other schema change (indexes, functions, stored procs). Scaffolds the correct migration script, updates dbex.yaml, applies the migration, and regenerates Infrastructure persistence models. DO NOT USE FOR: outbox provisioning (use dotnet run -- script outbox directly), seed data only changes (dotnet run -- Data), or CoreEx contract/service generation (that is *.CodeGen, not *.Database)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-db-migration/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-graphql.md

@@ -0,0 +1,14 @@
+---
+description: "Add or extend GraphQL-lite query support (CoreEx.Data.GraphQL) on a CoreEx *.Api host. USE FOR: first-time AddCoreExGraphQLLite/MapCoreExGraphQLLite wiring in Program.cs, registering AddQuery/AddGet roots over an entity's existing QueryArgsConfig, bulk-exposing reference data via AddReferenceDataQueries, adding a matching GraphQL root for an endpoint coreex-api just scaffolded, recording GraphQL enablement in the host's AGENTS.md. DO NOT USE FOR: REST controller endpoints (use coreex-api), defining or changing a QueryArgsConfig itself (use coreex-repository or coreex-refdata), general Program.cs setup unrelated to GraphQL (use coreex-scaffold)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-graphql/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-policy.md

@@ -0,0 +1,14 @@
+---
+description: "Create or modify a CoreEx Application-layer policy class. USE FOR: new policy class in Application/Policies/, EnsureExists guard (referenced entity must exist), business rule guards requiring I/O, multi-method policy, composing policies in Result<T> pipelines. DO NOT USE FOR: synchronous validation rules (use coreex-validator), Infrastructure repositories (use coreex-repository), application service scaffolding (use coreex-app-service)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-policy/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-refdata.md

@@ -0,0 +1,14 @@
+---
+description: "Add or modify a reference data type in a CoreEx domain. USE FOR: new ref-data entity (new table + seed rows + CodeGen), adding extra properties to an existing type, adding seed rows for an existing type, wiring an existing ref-data type into a contract. DO NOT USE FOR: non-reference-data entity tables (use coreex-db-migration), hand-authoring generated .g.cs contracts (always use CodeGen)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-refdata/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-repository.md

@@ -0,0 +1,14 @@
+---
+description: "Create or modify a CoreEx Infrastructure-layer repository. USE FOR: new repository class, adding CRUD operations, adding a custom query (QueryArgsConfig<TSelf>), bidirectional mapper (BiDirectionMapper), EfDb model accessor, Result<T> pipeline variants. DO NOT USE FOR: Application-layer service logic, domain invariants, typed HTTP clients/adapters (those follow adapter conventions in the infrastructure instructions, not this skill)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-repository/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-scaffold.md

@@ -1,5 +1,5 @@
 ---
-description: "CoreEx Solution Scaffolder — guides solution shaping after bootstrap (hosts, database, messaging, refdata/outbox/DDD/ROP options, and an optional Aspire AppHost for local multi-host orchestration/dashboard) and turns the answers into dotnet new template commands."
+description: "Guide a developer through CoreEx solution shaping after bootstrap, using a short plain-English interview that turns user answers into safe dotnet new template inputs. USE FOR: bootstrap-only repos, deciding API-only vs API plus relay vs API plus subscriber, choosing SQL Server vs Postgres vs no database, choosing refdata/outbox/DDD/ROP options, installing CoreEx.Template, checking current solution shape, adding missing Api/Relay/Subscribe hosts to an existing repo, adding a .NET Aspire AppHost for local multi-host orchestration and dashboard visibility, and optionally preparing a first local runnable state with local dependency assets plus database/code-generation steps. DO NOT USE FOR: unrelated runtime debugging, bootstrap creation, or forcing root re-scaffolding over an existing solution. INVOKES: workspace inspection, ask-questions style interviews, dotnet new install/list, dry-run validation, solution wiring, optional local dependency asset creation, focused build/test validation, and either template generation or manual retrofit work depending on repo shape."
 allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
 ---
 
@@ -11,4 +11,4 @@ allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
     propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
 -->
 
-Read `.github/skills/coreex-solution-scaffolder/SKILL.md` and follow the instructions in that file.
+Read `.github/skills/coreex-scaffold/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-subscriber-e2e.md

@@ -0,0 +1,14 @@
+---
+description: "Create a complete new event or command subscriber end-to-end in a single guided workflow: event/command DTO contract (if new), subscriber handler, optional application service and repository, and integration tests. USE FOR: adding a brand-new subscriber to an existing CoreEx Subscribe host for any scenario — command handling, event-data-sync replication, or event-driven business-process choreography. DO NOT USE FOR: modifying an existing subscriber (use coreex-subscriber directly), API endpoint work (use coreex-api-e2e), or setting up the Subscribe host itself (use coreex-scaffold)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-subscriber-e2e/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-subscriber.md

@@ -0,0 +1,14 @@
+---
+description: "Add or modify an event/command subscriber in a CoreEx Subscribe host. USE FOR: command subscriber (owns the contract, delegates to app service), event-data-sync subscriber (delegates to IXxxSyncAdapter), event-business-process subscriber (choreography step, delegates to app service). Covers SubscribedBase, SubscribedBase<T>, ValueValidator, ErrorHandler, and subject naming. DO NOT USE FOR: API controllers (use coreex-api), application services (use coreex-app-service), replication adapter implementations (use coreex-adapter), Subscribe host Program.cs setup (see coreex-host-setup.instructions.md), Subscribe-test integration tests (use coreex-test-subscribe)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-subscriber/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-test-api.md

@@ -0,0 +1,14 @@
+---
+description: "Write or update an integration test in a CoreEx *.Test.Api project. USE FOR: new XxxReadTests/XxxMutateTests partial classes, per-operation test files (Get/Query/Create/Update/Patch/Delete), OneTimeSetUp seeding + cache + outbox wiring, seed data (read-data.seed.yaml/mutate-data.seed.yaml), .res.json/.req.json resources, ETag/concurrency and soft-delete scenarios, outbox event assertions, inter-domain HTTP mocking. DO NOT USE FOR: Subscribe host tests (use coreex-test-subscribe), Outbox Relay host tests (use coreex-test-relay), pure unit tests with no infrastructure (validators/aggregates/adapters already cover their own Test.Unit guidance), the controller/endpoint implementation itself (use coreex-api)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-test-api/SKILL.md` and follow the instructions in that file.

.claude/commands/coreex-test-relay.md

@@ -0,0 +1,14 @@
+---
+description: "Understand, verify, or (rarely) extend an Outbox Relay host integration test in a CoreEx *.Test.Relay project. USE FOR: understanding the templated RelayTests.cs shape, verifying the relay forwards outbox events to the broker, hosted-service pause/resume endpoint checks, diagnosing Service Bus emulator entity-not-found failures. DO NOT USE FOR: API host tests (use coreex-test-api), Subscribe host tests (use coreex-test-subscribe), the relay host's Program.cs/hosted-service setup (see coreex-host-setup.instructions.md)."
+allowed-tools: [Read, Glob, Grep, Edit, Write, Bash]
+---
+
+<!--
+  AI workflow asset — dual-audience notice:
+  - In the Avanade/CoreEx repository: this file is the authored source. Edit it here.
+  - In a consumer repository: this file was generated by `dotnet new coreex-ai` (or refreshed via
+    `dotnet new coreex-ai --force` / the `/coreex-docs-sync` skill). Do not hand-edit it directly —
+    propose the change upstream in Avanade/CoreEx instead, then refresh once it is released.
+-->
+
+Read `.github/skills/coreex-test-relay/SKILL.md` and follow the instructions in that file.