/noop:make - Project Generator

Generate a complete, production-ready backend project following the noop architectural framework.

Framework Context

Core Philosophy

@docs/universal-framework/PHILOSOPHY.md

Architecture Specification

@docs/universal-framework/ARCHITECTURE_SPEC.md

Coding Conventions

@docs/universal-framework/CONVENTIONS.md

Scaffolding Specification

@docs/universal-framework/SCAFFOLDING_SPEC.md

Generator Instructions

@docs/universal-framework/GENERATOR_INSTRUCTIONS.md

---

What This Creates

• Express 5 with TypeScript (ESM)
• PostgreSQL with pgvector extension
• Redis/Valkey for caching
• Multi-tenant architecture with organization scoping
• Automatic semantic-versioned migrations
• Docker Compose setup for local development
• Health checks and graceful shutdown
• Zod-validated configuration
• Structured logging with sanitization

Arguments

$ARGUMENTS contains: [project-name] [--entities=Entity1,Entity2] [--port=3005] [--description="..."]

Execution Steps

Step 1: Parse Arguments or Prompt User

If $ARGUMENTS is empty, use the AskUserQuestion tool to gather:

1. Project name (lowercase, dashes allowed) - Example: inventory-service
2. Description - Example: "API service for inventory management"
3. Domain entities (optional, PascalCase) - Example: Product, Warehouse
4. Port (default: 3005) - Example: 3010

Step 2: Validate Inputs

• Project name: /^[a-z][a-z0-9-]*$/
• Entity names: /^[A-Z][a-zA-Z0-9]*$/
• Port: 1024-65535

Step 3: Confirm Generation Plan

Display to user:

Ready to generate:

Project: {project-name}
Description: {description}
Database: {database_name}
Port: {port}
Entities: {entities}
Target: ./{project-name}/

Proceed?

Step 4: Execute Generation

The template is at scaffold-template/. Copy it and process:

1. Copy scaffold-template to target directory

2. Replace placeholders in all files:

   • {{PROJECT_NAME}} → project name
   • {{PROJECT_DESCRIPTION}} → description
   • {{DATABASE_NAME}} → database name (underscores)
   • {{DEFAULT_PORT}} → port
   • {{EXAMPLE_ENTITY}} → first entity or "Widget"
   • {{EXAMPLE_ENTITY_LOWER}} → camelCase
   • {{EXAMPLE_ENTITY_PLURAL}} → plural
   • {{EXAMPLE_TABLE}} → snake_case

3. Generate additional entities if specified

4. Install dependencies: npm install

Step 5: Verify

Run verification:

• npm run typecheck
• npm run lint
• npm run build

Step 6: Report Success

Project generated at ./{project-name}/

Next steps:
1. cd {project-name}
2. Configure .env (JWT_SECRET, ENCRYPTION_KEY)
3. npm run docker:up
4. npm run dev

Available commands:
- /noop:entity-add - Add new domain entities
- /noop:review - Review code against architecture
- /noop:tend - Infrastructure maintenance