typescript

ACTIVATE when modeling DDD aggregates, domain logic, or business rules in TypeScript using functional patterns. ACTIVATE for 'aggregate', 'smart constructor', 'make', 'validation pipeline', 'enrichment', 'domain handler'. Covers: immutable aggregates as readonly types (not classes), curried domain operations, smart constructors (make* prefix), validation/enrichment pipelines, handler orchestration pattern. DO NOT use for: infrastructure code, general FP patterns (see ts-functional), OOP modeling (see ts-oop).

ACTIVATE whenever writing or modifying TypeScript code in src/. ACTIVATE for code review, formatting, or 'coding standards'. Covers: project-specific spacing rules around control structures (blank lines before/after if/for/while), early return pattern, continue vs if/else in loops, explicit checks (no truthy/falsy), parameter ordering. These go BEYOND standard linting. DO NOT use for: TypeScript typing rules (see ts-conventions), test conventions.

ACTIVATE when writing TypeScript types, generics, branded types, discriminated unions, or configuring tsconfig. ACTIVATE for 'type vs interface', 'enum alternative', 'branded type', 'satisfies', 'strict mode'. Covers: strict mode policy, no-any/no-enum rules, type over interface, discriminated unions, satisfies operator, branded types for ID safety, utility types. DO NOT use for: code formatting (see ts-code-conventions), functional patterns (see ts-functional).

ACTIVATE when implementing domain events, event store, outbox pattern, or reliable event publishing in TypeScript. ACTIVATE for 'domain event', 'outbox', 'event store', 'event-driven', 'reliable publishing'. Covers: domain event structure and naming, event store (append-only), outbox pattern for reliable publishing (no dual-write), consumer pattern. DO NOT use for: aggregate modeling (see ddd-ts-fp), general async patterns, message queue configuration.

ACTIVATE when writing functional-style TypeScript: pipe, compose, currying, Result types, railway-oriented programming, or AsyncResult. ACTIVATE for 'pipe', 'Result type', 'railway', 'functional', 'chain', 'flatMap'. Covers: type-safe pipe implementation, currying patterns, Result<T,E> type, railway-oriented error handling, AsyncResult for async pipelines. DO NOT use for: DDD aggregate modeling (see ddd-ts-fp), OOP patterns (see ts-oop), imperative code.

ACTIVATE when designing TypeScript classes, value objects, collections, or when the user asks about object design, encapsulation, Tell Don't Ask, or Symbol.iterator. Covers: Tell Don't Ask with TS examples, collection over named properties, Whole Object pattern, iterable collections via Symbol.iterator, self-descriptive value objects with branded types. DO NOT use for: functional DDD modeling (see ddd-ts-fp), refactoring methodology (see ts-refactoring).

ACTIVATE when the user wants to refactor, redesign, extract classes/value objects, or restructure TypeScript code. ACTIVATE for 'refactor', 'extract', 'redesign', 'simplify', 'clean up'. Covers: mandatory end-to-end flow analysis before refactoring, consumer-driven value object design, imports as coupling signals, value object completeness checklist. DO NOT use for: writing new features, general OOP patterns (see ts-oop).

ACTIVATE when conducting security assessments, code review for vulnerabilities, or CVSS scoring in TypeScript/Node.js/NestJS projects. ACTIVATE for 'security audit', 'vulnerability', 'injection', 'XSS', 'OWASP'. Covers: SQL injection prevention (Drizzle), XSS prevention, JWT security, password hashing, command/path injection, secrets management, CSRF, security checklist. DO NOT use for: general code quality, performance optimization, authentication flow design.