ddd-aggregate
Scaffold an aggregate root with entity, value objects, repository interface, domain events, and test stubs. Use when adding a new aggregate to an existing bounded context, modeling a new business concept that owns invariants, or generating the boilerplate for an entity + repo + events triplet.
Source facts
- Repository
- ruvnet/ruflo
- Last source activity
- July 17, 2026 at 03:06
- Detected SKILL.md language
- English
- Stars
- 73,010
- Forks
- 8,665
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- ddd-aggregate
- description
- Scaffold an aggregate root with entity, value objects, repository interface, domain events, and test stubs. Use when adding a new aggregate to an existing bounded context, modeling a new business concept that owns invariants, or generating the boilerplate for an entity + repo + events triplet.
- argument-hint
- <context> <aggregate-name>
- allowed-tools
- Bash Read Write Edit Grep Glob mcp__plugin_ruflo-core_ruflo__memory_store mcp__plugin_ruflo-core_ruflo__memory_search mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store mcp__plugin_ruflo-core_ruflo__hooks_pre-task mcp__plugin_ruflo-core_ruflo__hooks_post-task
Scaffold a complete aggregate root inside a bounded context.
Parse `$ARGUMENTS` as `<context-name> <aggregate-name>` (both kebab-case). The context must already exist under `src/`.
## Steps
1. **Validate**: Confirm `src/<context>/domain/` exists. If not, suggest running `/ddd-context <context>` first.
2. **Pre-task hook**: `npx @claude-flow/cli@latest hooks pre-task --description "DDD aggregate: <aggregate-name> in <context>"`
3. **Create aggregate root entity**:
- File: `src/<context>/domain/entities/<aggregate-name>.entity.ts`
- Include: unique ID field, constructor with invariant validation, domain methods that enforce business rules, `equals()` based on identity
- Export a TypeScript class extending or implementing a base `AggregateRoot` interface
4. **Create value objects**:
- File: `src/<context>/domain/value-objects/<aggregate-name>-id.value-object.ts`
- Include: immutable ID value object with factory method and validation
- Add additional value objects as properties of the aggregate suggest them
5. **Create repository interface**:
- File: `src/<context>/domain/repositories/<aggregate-name>.repository.ts`
- Include: `findById`, `save`, `delete` methods
- Use the aggregate root and its ID value object as types
- This is an interface only -- no implementation (infrastructure concern)
6. **Create domain events**:
- File: `src/<context>/domain/events/<aggregate-name>-created.event.ts`
- File: `src/<context>/domain/events/<aggregate-name>-updated.event.ts`
- Include: event name (past tense), timestamp, aggregate ID, payload
7. **Create unit test stubs**:
- File: `src/<context>/domain/entities/<aggregate-name>.entity.test.ts`
- Include: test cases for construction invariants, domain methods, equality
- Use `describe`/`it` with `should [behavior] when [condition]` names
8. **Update barrel exports**: Add new files to the relevant `index.ts` barrel files.
9. **Store in domain model graph**:
```
mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store --parent "context:<context>" --child "aggregate:<aggregate-name>" --relation "contains"
mcp__plugin_ruflo-core_ruflo__memory_store --key "ddd-aggregate-<context>-<aggregate-name>" --value "AGGREGATE_SUMMARY" --namespace tasks
```
10. **Post-task hook**: `npx @claude-flow/cli@latest hooks post-task --task-id "ddd-aggregate-<aggregate-name>" --success true --train-neural true`
View on GitHub