Project Scaffolder

---
name: Project Scaffolder
description: Production-grade project bootstrapper that creates complete development environments with security-first best practices. Validates stack/deployment compatibility, sets up CI/CD pipelines with stack-specific workflows, implements comprehensive testing, and creates architecture documentation. Features pluggable extensions and environment abstractions.
---

## Arguments
`/project-setup
name="<project-name>"
stack="<react|vue|nextjs|svelte|astro|remix|vite|express|fastapi|django|go-api|flutter>"
[deployment=<vercel|netlify|aws|docker|render|none>]
[features=<auth,database,testing,api,graphql,i18n,analytics>]
[license=<mit|apache|gpl|bsd3|mpl2>]
[security=<true|false>]
`
*Defaults → *`deployment=none  features=testing  license=mit  security=false`
### Examples
`# Basic setup with security features
/project-setup
name="my-saas-app"
stack=nextjs
deployment=vercel
features=auth,database,testing,api
license=mit
security=true

# API service with Docker deployment
/project-setup
name="api-service"
stack=fastapi
deployment=docker
features=database,testing,api

# Mobile app with minimal features
/project-setup
name="mobile-app"
stack=flutter
deployment=none
features=testing
`
---
## Context – what the AI should do
1. **Parse and Validate Arguments**
    - `name` - project name (validate naming conventions)
    - `stack` - technology stack to use
    - `deployment` - target deployment platform (validate compatibility)
    - `features` - comma-separated list of features (extensible)
    - `license` - open source license type (MIT, Apache 2.0, GPL, BSD-3, MPL-2.0)
    - `security` - enable security-first configuration
2. **Validation Rules:**
    - Flutter cannot deploy to Vercel/Netlify
    - Express + Netlify requires Functions configuration
    - Static sites (React/Vue/Svelte/Astro) + AWS need S3/CloudFront
    - Remix/Next.js work on all platforms (full-stack frameworks)
    - Vite projects deploy like static sites
    - API stacks require Docker or cloud deployment
3. **Project Structure Creation**
    - Create root directory: `/filesystem__create_directory path=./${name}`
    - Generate tech stack specific folder structure
    - Set up source, test, config, and documentation directories
    - Create environment-specific configuration files
4. **Stack-Specific Setup**
    - **React/Next.js**: package.json, tsconfig.json, tailwind config, API routes
    - **Vue**: vue.config.js, router setup, store configuration
    - **Svelte**: svelte.config.js, SvelteKit structure, adapter configuration
    - **Astro**: astro.config.mjs, content collections, island architecture
    - **Remix**: remix.config.js, routes structure, loader/action patterns
    - **Vite**: vite.config.js, vanilla TS/JS structure, HMR setup
    - **Express**: server structure, middleware setup, route organization
    - **FastAPI/Django**: app structure, models, serializers, requirements.txt
    - **Go**: go.mod, main.go, handler structure, middleware
    - **Flutter**: pubspec.yaml, lib structure, platform configurations
5. **Security & Compliance Layer** (if security=true)
    - **Dependency Scanning**: Dependabot config, Snyk integration
    - **Secret Management**: Git-secrets hooks, .gitleaks.toml
    - **Supply Chain**: SLSA attestation, SBOM generation
    - **Security Workflows**: SAST scanning, container scanning
    - **Compliance Templates**: SOC2, HIPAA, GDPR documentation stubs
6. **Feature Integration** (Pluggable System)
    - **Core Features**:

        - **Authentication**: Auth providers, JWT/OAuth, protected routes
        - **Database**: ORM setup, migrations, connection pooling
        - **Testing**: Unit/integration/e2e frameworks, coverage
        - **API**: REST/GraphQL endpoints, versioning, rate limiting
    - **Extended Features** (via features+=):

        - **GraphQL**: Schema definition, resolvers, subscriptions
        - **i18n**: Locale files, translation keys, RTL support
        - **Analytics**: GA4, Mixpanel, custom event tracking
        - **Monitoring**: OpenTelemetry, error tracking, APM
    - **Community Plugins**: Register via SQLite, auto-discover
7. **Development Tools Configuration**
    - Version control: `.gitignore`, `.gitattributes`, README.md
    - Code quality: ESLint, Prettier, pre-commit hooks
    - Environment: `.env.development`, `.env.test`, `.env.production`, `.env.example`
    - Docker: Multi-stage Dockerfile, docker-compose variants
    - CI/CD: Stack-specific GitHub Actions workflows
    - Security: Dependabot, secret scanning, SAST tools (if security=true)
8. **Documentation Generation**
    - **README.md**: Project overview, setup instructions, usage examples
    - **CONTRIBUTING.md**: Development guidelines, code style, PR process
    - **API Documentation**: Auto-generated API docs based on stack
    - **Architecture Diagram**: High-level system design explanation
9. **Deployment Configuration**
    - **Vercel**: vercel.json, environment variables setup
    - **Netlify**: netlify.toml, build configuration
    - **AWS**: CloudFormation templates, deployment scripts
    - **Docker**: Multi-stage Dockerfile, docker-compose for development
    - **Render**: render.yaml, environment groups, preview environments
10. **Stack-Specific CI/CD Templates**
    - **Node.js stacks**: `.github/workflows/node-test.yml`, `node-lint.yml`
    - **Svelte/Astro/Remix/Vite**: `.github/workflows/node-test.yml` with framework-specific builds
    - **Python stacks**: `.github/workflows/python-django.yml`, `python-fastapi.yml`
    - **Go**: `.github/workflows/go-ci.yml` with `go vet`, `go test`
    - **Flutter**: `.github/workflows/flutter-ci.yml` with analyze/test
    - **Deployment**: `deploy-vercel.yml`, `deploy-aws.yml`, `docker-build.yml`
11. **Knowledge Base and Templates**
    - Store successful configurations in memory/SQLite
    - Track stack/deployment compatibility matrix
    - Learn from common patterns and successful combinations
    - Update SQLite with project metadata and success metrics
12. **Post-Setup Verification & Smoke Tests**
    - **Node.js (React/Vue/Next.js)**: Run `npm install && npm run build && npm test`
    - **Svelte**: Run `npm install && npm run check && npm run build`
    - **Astro**: Run `npm install && npm run build`
    - **Remix**: Run `npm install && npm run build && npm run typecheck`
    - **Vite**: Run `npm install && npm run build`
    - **Python**: Run `pip install -r requirements.txt && pytest`
    - **Go**: Run `go mod download && go vet ./... && go test ./...`
    - **Flutter**: Run `flutter pub get && flutter analyze`
    - Fail fast with actionable error logs
    - Generate setup verification report
13. **Documentation Generation**
    - **Architecture Diagrams**: Mermaid-based system diagrams
    - **API Docs**: Swagger/OpenAPI for REST, GraphQL schemas
    - **Stack-specific**: TSDoc for TypeScript, GoDoc for Go
    - **README**: Include quickstart, architecture, deployment guides
> Create production-grade projects with security-first practices, validated configurations, and comprehensive testing. Supports extensible features and learns from successful project patterns for consistent, reliable project bootstrapping.