AI Agent Empowerment - SKILL.md

[dgoerdes]

Nimbus Philosophy of "no magic, explicit code" and the recommendation of a Pure Core & Imperative Shell architecture are great for AI scaffolding.

What we had with CLI's for boilerplate and scaffolding in the past, we can simply do with AI Agents today.

So I guess it would be helpful to define a set of skills that boost AI Agents when working with Nimbus.

Examples:

• add-command: scaffolds core/commands/x.command.ts (Zod schema + pure fn) + shell/commands/x.command.ts (handler) + handler registration + a test stub. Mirrors the pattern in examples/eventsourcing-demo/src/write/iam/users/core/commands/inviteUser.command.ts.
• add-event: creates the event type + Zod schema + CloudEvents-compliant type string.
• add-query + add-projection: read-side counterpart, including the MongoDB view shape and the event observer wiring.
• add-domain / add-module: creates the DDD folder skeleton <domain>/<module>/{core,shell} with commands/, events/, domain/.
• wire-http-route: adds a Hono route + plugs into commandRouter.
• evolve-event: guides through event versioning / upcasting (because event-sourcing apps live and die by getting this right).
• write-pure-core-test: a "given events, when command, then events" template; pure functions are trivial for an LLM to test if you give it the shape.

Distribution

Simply in the Docs or as a separate @nimbus-cqrs/skills package to be installed.

Also publish a docs/guide/agents.md page to provide a copy-pasteable AGENTS.md template for downstream Nimbus projects.

[dgoerdes]

We should use https://www.npmjs.com/package/skills for distribution.

[dgoerdes]

We should also add a skill to work with https://www.esdm.io/ so AI knows how to use ESDM files to generate command, events and queries from it.

FYI @goloroden