ddd-aggregate
Scaffold an aggregate root with entity, value objects, repository interface, domain events, and test stubs
Best for DDD projectsWorks with GitHubLow risk
⌘source
- author
@ruvnet- repo
- ruvnet/ruflo
- language
- TypeScript
★46kstars
5.1kforks
May 5, 2026
✦overview.md
Key Features
- ·Validates context existence
- ·Generates aggregate root entity with invariants
- ·Creates value objects for ID and properties
- ·Generates repository interface
- ·Produces domain events and test stubs
Use Cases
- →Scaffolding a new aggregate in an existing bounded context
- →Standardizing aggregate structure across a DDD project
- →Quickly generating repository and domain event boilerplate
Best for
- ✓DDD projects
- ✓new aggregates
- ✓consistent scaffolding
Not ideal for
- !non-DDD architectures
- !existing aggregates without refactoring
FAQs
name
ddd-aggregate
description
Scaffold an aggregate root with entity, value objects, repository interface, domain events, and test stubs
argument-hint:<context> <aggregate-name>
allowed-tools:Bash(mkdir * find * ls *) Read Write Edit Grep Glob mcp__claude-flow__memory_store mcp__claude-flow__memory_search mcp__claude-flow__agentdb_hierarchical-store mcp__claude-flow__hooks_pre-task mcp__claude-flow__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
-
Validate: Confirm
src/<context>/domain/exists. If not, suggest running/ddd-context <context>first. -
Pre-task hook:
npx @claude-flow/cli@latest hooks pre-task --description "DDD aggregate: <aggregate-name> in <context>" -
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
AggregateRootinterface
- File:
-
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
- File:
-
Create repository interface:
- File:
src/<context>/domain/repositories/<aggregate-name>.repository.ts
- File:
$install
1-click copynpx skills add ruvnet/ruflo --skill ddd-aggregateSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.