gsd-installer

GSD Installer for nestjs-hexagonal

Configures a NestJS project so that GSD workflows automatically leverage the nestjs-hexagonal plugin's skills and agents.

What This Does

1. Adds a skill mapping section to the project's CLAUDE.md so GSD executor agents know which skills to invoke
2. Creates a GSD roadmap template with phases that map to plugin agents
3. Optionally updates .planning/PROJECT.md if GSD is already initialized

Step 1: Detect Project State

Check what exists:

# GSD initialized?
ls .planning/PROJECT.md 2>/dev/null

# CLAUDE.md exists?
ls CLAUDE.md 2>/dev/null

# NestJS project?
ls nest-cli.json 2>/dev/null || ls apps/*/nest-cli.json 2>/dev/null

# Plugin installed?
ls .claude-plugin/plugin.json 2>/dev/null || grep -r "nestjs-hexagonal" ~/.claude/plugins/ 2>/dev/null

Step 2: Add Skill Mapping to CLAUDE.md

Append this section to the project's CLAUDE.md (create if not exists):

## NestJS Hexagonal Architecture (nestjs-hexagonal plugin)

### Skill Mapping for GSD Phases

When executing GSD phases that involve creating or modifying bounded contexts, use these skills and agents:

| Task | Skill / Agent | Model |
|------|---------------|-------|
| Domain modeling (entities, VOs, events) | `nestjs-hexagonal:domain-agent` | Opus 5 |
| Application layer (use cases, handlers) | `nestjs-hexagonal:application-agent` | Sonnet 5 |
| Infrastructure (repos, modules, adapters) | `nestjs-hexagonal:infrastructure-agent` | Sonnet 5 |
| Presentation (controllers, DTOs, Swagger) | `nestjs-hexagonal:presentation-agent` | Sonnet 5 |
| WebSocket broadcasting | `nestjs-hexagonal:broadcasting-agent` | Sonnet 5 |
| Architecture review | `nestjs-hexagonal:architecture-reviewer` | Opus 5 |
| Full BC scaffold | `nestjs-hexagonal:create-subdomain` | Orchestrator |
| Event chain debugging | `nestjs-hexagonal:event-debug-agent` | Opus 5 |

### Architecture Rules (enforced)

1. Entity extends `AggregateRoot` from `@nestjs/cqrs`
2. Repository is PURE persistence — no event dispatch
3. EventPublisher in Handler only, NEVER in UseCase
4. Module exports ONLY Port tokens
5. class-validator ONLY in presentation request DTOs
6. Write returns void or `{ id: string }`

### GSD Phase Template for Bounded Context

When creating a new bounded context via GSD, use this phase structure:

Phase X: <BC Name> Domain + Application
  - Task 1: Domain modeling (dispatch domain-agent, Opus 5)
  - Task 2: Application layer (dispatch application-agent, Sonnet 5)

Phase X+1: <BC Name> Infrastructure + Presentation
  - Task 1: Infrastructure wiring (dispatch infrastructure-agent, Sonnet 5)
  - Task 2: Presentation layer (dispatch presentation-agent, Sonnet 5)
  - Task 3: Architecture review (dispatch architecture-reviewer, Opus 5)