Project Scaffolder

Generate production-ready starter repositories with best-practice conventions for any tech stack.

Core Workflow

Determine stack: Ask user to specify or infer from context (Next.js, Vite, Nest, FastAPI, etc.)
Select template: Use references/templates.md to choose the appropriate project structure
Generate structure: Create complete folder tree with all necessary files
Add baseline code: Include working "hello world" route/page as proof of concept
Configure tooling: Add package.json/requirements.txt, tsconfig, linting, formatting configs
Create scripts: Include dev, build, test, and deployment scripts
Document setup: Generate comprehensive README with setup steps and next actions

Key Deliverables

Every scaffolded project must include:

Folder tree: Well-organized src/, lib/, config/, tests/ structure
Baseline code: Working hello world endpoint or page
Package files: package.json, requirements.txt, Cargo.toml, etc.
Configs: TypeScript, ESLint, Prettier, environment files (.env.example)
Scripts: npm scripts or Makefile for common tasks
README: Setup instructions, tech stack overview, next steps
Git setup: .gitignore configured for the stack

Stack-Specific Patterns

See references/templates.md for detailed patterns per stack:

Next.js App Router
Vite + React
NestJS
FastAPI
Express + TypeScript
Vue + Vite
SvelteKit

Best Practices

Use absolute imports (@/ alias) where supported
Include environment variable templates
Add basic error handling and logging setup
Configure path mappings in tsconfig
Include Docker files for containerization (optional)
Add GitHub Actions or CI workflow templates (optional)

Progressive Enhancement

Start with minimal viable structure, then add:

Database setup (Prisma, TypeORM, SQLAlchemy)
Auth scaffolding (NextAuth, Passport, JWT)
API client setup (Axios, Fetch wrapper)
State management (Zustand, Redux, Pinia)
Testing setup (Jest, Vitest, Pytest)

Output Structure

Present the complete project tree first, then create all files in proper locations. Always provide a summary of what was created and next steps to run the project.