nestjs-nextjs-monorepo

Analyze the codebase architecture — modules, services, patterns, and cross-cutting concerns. Produces a clear structural overview with ASCII diagrams.

Map all module and package dependencies in the monorepo — internal packages, NestJS module imports, and cross-service communication. Produces a dependency graph with circular dependency detection.

Find and list all system entry points — HTTP routes, microservice patterns, queue jobs, health endpoints, and CLI commands. Produces a complete inventory with file references.

Generate or update project documentation — PROJECT_MAP.md, ARCHITECTURE_OVERVIEW.md, ENTRYPOINTS.md, CONVENTIONS.md, DEPENDENCY_GRAPH.md. Scans the codebase and writes accurate docs.

Guided onboarding for new developers joining this monorepo. Walks through architecture, key concepts, development workflow, and a first task. Tailored to the developer's experience level.

Performance audit of the codebase — identifies N+1 queries, missing indexes, slow queue jobs, unoptimized data access patterns, and Redis cache opportunities. Produces a prioritized report.

Safely refactor a NestJS module or Next.js component — extract abstractions, reduce duplication, improve naming, fix convention deviations. Follows the monorepo's patterns and validates the build after changes.

Security audit of the codebase — checks authentication, authorization, input validation, secret handling, injection risks, and OWASP Top 10 concerns. Produces a prioritized findings report.

Test-driven development guide for this monorepo — write tests before implementation, following the project's testing stack (Jest, nestjs testing utilities). Covers unit, integration, and e2e test patterns.

Trace the complete lifecycle of an HTTP request or event through the system — from entrypoint to database and back. Produces a step-by-step flow with file references.