ddd-spec

Generates complete DDD strategic modeling documents with Event Storming, Bounded Contexts, and TypeScript API specifications.

4|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/gabriellst/codm --skill ddd-spec-gabriellst
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ddd-spec
Source: https://github.com/gabriellst/codm/tree/main/.claude/skills/ddd-spec
Command: npx skills add https://github.com/gabriellst/codm --skill ddd-spec-gabriellst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough system idea into a rigorous Domain-Driven Design specification normally requires days of architecture work. This Skill produces a complete strategic design document — from requirements through Event Storming to a full TypeScript API spec — in a single structured workflow. ## Core Features & Use Cases - Full Strategic Pipeline: Generates all 7 sections of a DDD spec: high-level requirements, Event Storming with emoji markers, screens & commands tables, Bounded Context separation, Context Mapping with ASCII diagrams, design decisions, and a technical API specification. - Type-Safe API Contracts: Produces Input/Output/Errors TypeScript type definitions for every screen (Tnn) and command (Cnn), with shared enums, discriminated unions, and domain event annotations. - Automated Self-Review: Runs a structured R1–R5 review checklist (completeness, language, type safety, internal consistency, formatting) and fixes issues before delivering the document. - Use Case: Describe a billing platform idea and receive a 2000–4000 line Markdown spec covering Bounded Contexts, integration events, error code glossaries, and per-command TypeScript contracts ready for implementation. ## Quick Start Ask the assistant to create a full DDD specification document for your system idea, describing the actors, key domain concepts, and main operations.

Frequently Asked Questions about ddd-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a DDD specification document for a new system?

Describe your system idea including actors, key domain concepts, and main operations. The Skill generates a 7-section document covering requirements, Event Storming, screens and commands, Bounded Contexts, Context Mapping, and a full TypeScript API specification.

What sections does a Domain-Driven Design spec document include?

The document contains high-level requirements, an Event Storming timeline with emoji markers, screens and commands tables, Bounded Context separation with aggregates, Context Mapping with ASCII diagrams, design decisions, and a technical specification with TypeScript types.

How are TypeScript API contracts defined for commands and reads?

Every screen and command gets Input, Output, and Errors type definitions using the type keyword. IDs are strings, dates are ISO 8601 strings, monetary values use amountCents, and domain events appear as TypeScript comments.

Does the generated DDD document get reviewed before delivery?

Yes, a structured self-review runs five check groups: completeness, English-only language, type safety, internal consistency, and formatting. Failed checks are fixed directly in the file and re-verified before the document is delivered.

When should I not use a full DDD strategic specification?

Avoid it for small scripts, prototypes, or single-context CRUD apps where strategic modeling overhead exceeds the value. The pipeline is designed for multi-context systems with complex domain logic and cross-team boundaries.