scaffold

name	scaffold
description	Generate a new project skeleton from scratch based on the user's chosen tech stack. Use when starting a new project and needing the initial directory structure, config files, and boilerplate set up correctly.

Scaffold

Generate a complete, runnable project skeleton for a new project.

Steps

1. Gather requirements — Ask the user if not already specified:

   • Project type (web app, CLI tool, library, API server, etc.)
   • Language and framework (e.g., TypeScript + Next.js, Python + FastAPI, Go, Rust)
   • Key features needed at the start (auth, database, testing, linting, Docker)
   • Package manager preference (npm, pnpm, yarn, pip, cargo, etc.)

2. Confirm the plan — Before creating any files, list what will be generated:

   • Directory structure
   • Key config files (package.json, tsconfig.json, pyproject.toml, etc.)
   • Boilerplate files

   Get confirmation before proceeding.

3. Generate the project — Create all files in order:

   • Config files first (package manager, compiler, linter)
   • Directory skeleton
   • Entry point files with minimal working code
   • README with setup instructions

4. Verify it runs — Execute the appropriate commands to confirm the scaffold works:

   # Example for Node.js
   pnpm install && pnpm build
   # or
   pnpm dev
   

5. Report — Summarize what was created and the commands needed to run, test, and build the project.

Principles

• Generate the minimal working scaffold, not a kitchen-sink template.
• Prefer the project's ecosystem conventions (e.g., src/ layout for TS, app/ for Next.js).
• Include a .gitignore appropriate for the tech stack.
• Do not add dependencies the user did not ask for.