# Create Subdomain

> Orchestrates creation of a NestJS bounded context by dispatching specialized agents per layer (domain, application, infrastructure, presentation). Uses Opus for domain modeling, Sonnet for execution layers. Compatible with GSD workflow (usable as phase execution). Follows TDD, Hexagonal Architecture, DDD, and CQRS.

- **Type:** Skill
- **Install:** `agentstack add skill-softtor-nestjs-hexagonal-create-subdomain`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Softtor](https://agentstack.voostack.com/s/softtor)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Softtor](https://github.com/Softtor)
- **Source:** https://github.com/Softtor/nestjs-hexagonal/tree/main/skills/create-subdomain
- **Website:** https://github.com/Softtor/nestjs-hexagonal#readme

## Install

```sh
agentstack add skill-softtor-nestjs-hexagonal-create-subdomain
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# create-subdomain

Orchestrator that dispatches specialized agents per architectural layer. Each agent loads its corresponding skill and follows TDD.

> **Agent Dispatch:** The dispatch blocks below are conceptual templates. In Claude Code, dispatch agents using the `Agent` tool with a `prompt` string that includes "Load skill nestjs-hexagonal: for patterns." The agent's model and tools are defined in the agent `.md` file frontmatter, not in the tool call.

Compatible with GSD: each phase maps to a GSD execution step.

---

## Phase 1 — Requirements Gathering (inline)

Ask the user via `AskUserQuestion`. Collect all answers before dispatching agents.

1. Bounded context name and business purpose?
2. Main entities? Which is the aggregate root?
3. Value objects needed? (money, status, email, document, etc.)
4. Domain events? (created, updated, status-changed, cancelled)
5. Multi-tenant? Field name? (`organizationId` or `companyId`)
6. CQRS pattern? (A: plain UseCase, B: Command/Query, C: Handler as Orchestrator)
7. RBAC guards on endpoints?
8. Sub-modules? (e.g., subscription -> plans, payments, core)
9. Cross-module ports needed? (which existing modules to communicate with)
10. Read model projection in Redis? (CQRS R/W separation)

After answers, create the directory structure:

```
/
├── domain/
│   ├── entities/__tests__/
│   ├── value-objects/__tests__/
│   ├── events/
│   ├── repositories/
│   ├── services/
│   └── testing/helpers/
├── application/
│   ├── dtos/
│   ├── commands/          # Pattern B/C
│   ├── queries/           # Pattern B/C
│   ├── usecases/          # Pattern A/C
│   └── ports/
└── infrastructure/
    ├── .module.ts
    ├── controllers/dtos/
    ├── database/prisma/repositories/
    ├── database/prisma/models/
    ├── database/in-memory/repositories/
    ├── adapters/
    └── listeners/
```

---

## Phase 2 — Domain Layer via `domain-agent` (Opus 4.6)

Dispatch the domain-agent with context from Phase 1:

```
Agent tool:
  subagent_type: "nestjs-hexagonal:domain-agent"
  model: opus
  prompt: |
    Create domain layer for "" at "".
    Entity: , Props: 
    VOs: , Events: 
    Multi-tenant: 
    TDD: tests first. Load skill nestjs-hexagonal:domain.
```

The agent will create: entity + tests, VOs + tests, events, repository interface, data builders. Verify types compile.

**Wait for completion before Phase 3.**

---

## Phase 3 — Application Layer via `application-agent` (Sonnet 4.6)

```
Agent tool:
  subagent_type: "nestjs-hexagonal:application-agent"
  model: sonnet
  prompt: |
    Create application layer for "" at "".
    Pattern: , Operations: 
    Ports: , Read model: 
    Domain layer at "/domain/".
    TDD: tests first. Load skill nestjs-hexagonal:application.
```

Creates: DTOs, use cases/handlers, ports, tests.

**Wait for completion before Phase 4.**

---

## Phase 4 — Infrastructure Layer via `infrastructure-agent` (Sonnet 4.6)

```
Agent tool:
  subagent_type: "nestjs-hexagonal:infrastructure-agent"
  model: sonnet
  prompt: |
    Create infrastructure layer for "" at "".
    Pattern: , Ports to implement: 
    Event handlers: 
    Load skill nestjs-hexagonal:infrastructure.
```

Creates: Prisma repo, model mapper, in-memory repo, adapters, event handlers, module wiring.

**Wait for completion before Phase 5.**

---

## Phase 5 — Presentation Layer via `presentation-agent` (Sonnet 4.6)

Skip if no HTTP endpoints needed.

```
Agent tool:
  subagent_type: "nestjs-hexagonal:presentation-agent"
  model: sonnet
  prompt: |
    Create presentation layer for "" at "".
    Pattern: , Endpoints: 
    RBAC: 
    Load skill nestjs-hexagonal:presentation.
```

Creates: controller, request DTOs, Swagger, module registration.

**Wait for completion before Phase 6.**

---

## Phase 6 — Verification (inline)

Run directly, no agent needed:

```bash
pnpm check-types
pnpm lint
pnpm test --filter 
pnpm build
```

All must exit 0. Fix root causes, no suppression.

---

## Phase 7 — Architecture Review via `architecture-reviewer` (Sonnet 4.6)

```
Agent tool:
  subagent_type: "nestjs-hexagonal:architecture-reviewer"
  model: sonnet
  prompt: |
    Review bounded context at "".
    Check all 6 dimensions. Produce Pass/Warning/Fail report.
```

Address every FAIL. Report to user: structure, pattern, decisions, deferred warnings.

---

## GSD Compatibility

This workflow maps directly to GSD phases:

| GSD Phase | create-subdomain Phase | Agent |
|---|---|---|
| Research | Phase 1 (requirements) | inline |
| Execute task 1 | Phase 2 (domain) | domain-agent (Opus) |
| Execute task 2 | Phase 3 (application) | application-agent (Sonnet) |
| Execute task 3 | Phase 4 (infrastructure) | infrastructure-agent (Sonnet) |
| Execute task 4 | Phase 5 (presentation) | presentation-agent (Sonnet) |
| Verify | Phase 6 (verification) | inline |
| Review | Phase 7 (review) | architecture-reviewer (Sonnet) |

When used within GSD, each phase can be a separate GSD task tracked in the plan.

---

## Anti-Patterns

| Anti-pattern | Correction |
|---|---|
| Use case for simple `findById` without RBAC | Repository directly in controller |
| `EventPublisher` in UseCase | Only in the CQRS Handler |
| Exporting repositories from module | Export only Port token Symbols |
| `class-validator` in domain VOs | Manual `validate()` with `InvalidArgumentError` |
| Repository dispatching events | Repository is pure persistence |
| Circular module dependencies | Ports in consumer, adapter in provider |
| Mixing patterns A/B/C in one BC | Choose one, apply consistently |
| Creating abstractions for one-time use | YAGNI — 3 lines > premature abstraction |
| `@Injectable` in domain or UseCase | Only in infrastructure + CQRS handlers |
| `Entity.create()` in mapper | Use `Entity.restore()` to avoid event emission |
| `organizationId` from request body | Always from `@CurrentOrganization()` auth context |
| Writing implementation before test | TDD: red -> green -> refactor |

---

## References

| File | Content |
|---|---|
| `references/tdd-workflow.md` | Test templates and TDD sequence per layer |
| `references/checklist.md` | 30+ item delivery checklist grouped by layer |
| `references/bc-organization.md` | When and how to split a BC into sub-modules |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Softtor](https://github.com/Softtor)
- **Source:** [Softtor/nestjs-hexagonal](https://github.com/Softtor/nestjs-hexagonal)
- **License:** MIT
- **Homepage:** https://github.com/Softtor/nestjs-hexagonal#readme

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-softtor-nestjs-hexagonal-create-subdomain
- Seller: https://agentstack.voostack.com/s/softtor
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.