nextjs-fullstack-scaffold

# Next.js Full-Stack Scaffold

To scaffold a production-grade Next.js 16 full-stack application with modern tooling and best practices, follow these steps systematically.

## Prerequisites Check

Before scaffolding, verify the target directory:
1. Confirm the current working directory is where files should be generated
2. Check if directory is empty or if user wants to override existing files
3. Confirm user wants to proceed with scaffold generation

## Step 1: Gather Project Information

Prompt the user for the following details using the AskUserQuestion tool:
- Project name (for package.json)
- Project description
- Author name

Use sensible defaults if user prefers to skip.

## Step 2: Create Folder Structure

Create the complete folder structure as defined in `assets/folder-structure.txt`. Generate all necessary directories by writing files to them (directories are created automatically).

## Step 3: Generate Configuration Files

Create all configuration files in the project root. Consult `references/stack-architecture.md` for architectural guidance.

### Essential Config Files

Generate these files using Write tool:
- **package.json** - Use template from `assets/templates/package.template.json`, replacing placeholders
- **tsconfig.json** - TypeScript config with strict mode and path aliases
- **next.config.ts** - Next.js configuration with server actions
- **tailwind.config.ts** - Tailwind v4 with dark mode and shadcn/ui colors
- **postcss.config.mjs** - PostCSS with Tailwind plugin
- **eslint.config.mjs** - ESLint v9 flat config
- **prettier.config.js** - Prettier with Tailwind plugin
- **.gitignore** - Standard Next.js ignore patterns
- **.env.example** - Environment variable template
- **vitest.config.ts** - Vitest test configuration
- **playwright.config.ts** - Playwright E2E configuration

## Step 4: Generate App Router Files

Create all Next.js app router files following RSC conventions.

### Root Files
- `app/layout.tsx` - Root layout with metadata and p