V3 DDD Architecture

Decomposes monolithic orchestrator code into bounded contexts using Domain-Driven Design and microkernel patterns.

1|1|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/33may/robotics --skill v3-ddd-architecture-33may
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: V3 DDD Architecture
Source: https://github.com/33may/robotics/tree/main/humanoid/.claude/skills/v3-ddd-architecture
Command: npx skills add https://github.com/33may/robotics --skill v3-ddd-architecture-33may

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large TypeScript codebases often accumulate god objects—like a 1,440-line orchestrator handling tasks, sessions, health, and lifecycle—which become untestable and hard to maintain. This Skill guides the decomposition of such monoliths into modular, bounded contexts with clean architecture. ## Core Features & Use Cases - Domain Decomposition: Breaks god objects into focused domains (task management, session management, health monitoring) with entities, value objects, services, and repositories. - Microkernel & Plugin Architecture: Implements a core kernel that loads domains and supports optional plugins like swarm coordination. - Event-Driven Communication: Defines domain events and handlers for loose coupling between bounded contexts. - Use Case: Refactoring a claude-flow orchestrator into five independent domains, each under 300 lines, with >90% domain test coverage and a phased migration plan. ## Quick Start Ask the AI to analyze the current orchestrator architecture and design DDD bounded contexts with clean interfaces and a migration plan.

Frequently Asked Questions about V3 DDD Architecture

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

FAQPage Schema
How do I break down a god object into DDD bounded contexts?

Identify the distinct responsibilities in the god object, then map each to a bounded context with its own entities, value objects, services, and repositories. Extract one domain at a time using a phased migration plan, wiring communication through domain events.

What is the microkernel architecture pattern in TypeScript?

A microkernel architecture uses a minimal core kernel that loads domains and plugins at runtime through a registry and dependency container. Plugins declare dependencies on core domains and register their services with the kernel during initialization.

How do bounded contexts communicate in DDD?

Bounded contexts communicate through domain events published to an event bus rather than direct method calls. Each context subscribes handlers to events from other domains, keeping coupling loose and contexts independently testable.

Does clean architecture require dependency injection?

Clean architecture requires dependency inversion, which is typically implemented with dependency injection. Use cases and controllers receive repository and service interfaces through constructors, so the domain layer has no external dependencies.

When should I not use Domain-Driven Design?

DDD adds structural overhead that is not justified for small CRUD applications or prototypes with simple logic. It pays off when a codebase has complex business rules, multiple interacting concerns, or god objects that block testing and parallel development.