{"aiPlatform":"claude-code@2025.06","category":"development","commandName":"/project-setup","content":"---\nname: Project Scaffolder\ndescription: 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.\nallowed_tools:\n  - filesystem      # Create project structure and files\n  - github          # Initialize repository and setup workflows\n  - memory          # Track project templates and best practices\n  - sqlite          # Store project configurations and templates\ntags:\n  - scaffolding\n  - dev-ops\n  - ci-cd\n  - project-setup\n  - automation\ncategory: development\n---\n\n## Arguments\n\n```\n/project-setup \nname=\"<project-name>\"\nstack=\"<react|vue|nextjs|svelte|astro|remix|vite|express|fastapi|django|go-api|flutter>\"\n[deployment=<vercel|netlify|aws|docker|render|none>]\n[features=<auth,database,testing,api,graphql,i18n,analytics>]\n[license=<mit|apache|gpl|bsd3|mpl2>]\n[security=<true|false>]\n```\n*Defaults → `deployment=none  features=testing  license=mit  security=false`*\n\n### Examples\n\n```bash\n# Basic setup with security features\n/project-setup \nname=\"my-saas-app\"\nstack=nextjs\ndeployment=vercel\nfeatures=auth,database,testing,api\nlicense=mit\nsecurity=true\n\n# API service with Docker deployment\n/project-setup \nname=\"api-service\"\nstack=fastapi\ndeployment=docker\nfeatures=database,testing,api\n\n# Mobile app with minimal features\n/project-setup \nname=\"mobile-app\"\nstack=flutter\ndeployment=none\nfeatures=testing\n```\n\n---\n\n## Context – what the AI should do\n\n1. **Parse and Validate Arguments**\n   * `name` - project name (validate naming conventions)\n   * `stack` - technology stack to use\n   * `deployment` - target deployment platform (validate compatibility)\n   * `features` - comma-separated list of features (extensible)\n   * `license` - open source license type (MIT, Apache 2.0, GPL, BSD-3, MPL-2.0)\n   * `security` - enable security-first configuration\n   \n   **Validation Rules:**\n   * Flutter cannot deploy to Vercel/Netlify\n   * Express + Netlify requires Functions configuration\n   * Static sites (React/Vue/Svelte/Astro) + AWS need S3/CloudFront\n   * Remix/Next.js work on all platforms (full-stack frameworks)\n   * Vite projects deploy like static sites\n   * API stacks require Docker or cloud deployment\n\n2. **Project Structure Creation**\n   * Create root directory: `/filesystem__create_directory path=./${name}`\n   * Generate tech stack specific folder structure\n   * Set up source, test, config, and documentation directories\n   * Create environment-specific configuration files\n\n3. **Stack-Specific Setup**\n   * **React/Next.js**: package.json, tsconfig.json, tailwind config, API routes\n   * **Vue**: vue.config.js, router setup, store configuration\n   * **Svelte**: svelte.config.js, SvelteKit structure, adapter configuration\n   * **Astro**: astro.config.mjs, content collections, island architecture\n   * **Remix**: remix.config.js, routes structure, loader/action patterns\n   * **Vite**: vite.config.js, vanilla TS/JS structure, HMR setup\n   * **Express**: server structure, middleware setup, route organization\n   * **FastAPI/Django**: app structure, models, serializers, requirements.txt\n   * **Go**: go.mod, main.go, handler structure, middleware\n   * **Flutter**: pubspec.yaml, lib structure, platform configurations\n\n4. **Security & Compliance Layer** (if security=true)\n   * **Dependency Scanning**: Dependabot config, Snyk integration\n   * **Secret Management**: Git-secrets hooks, .gitleaks.toml\n   * **Supply Chain**: SLSA attestation, SBOM generation\n   * **Security Workflows**: SAST scanning, container scanning\n   * **Compliance Templates**: SOC2, HIPAA, GDPR documentation stubs\n\n5. **Feature Integration** (Pluggable System)\n   * **Core Features**:\n     - **Authentication**: Auth providers, JWT/OAuth, protected routes\n     - **Database**: ORM setup, migrations, connection pooling\n     - **Testing**: Unit/integration/e2e frameworks, coverage\n     - **API**: REST/GraphQL endpoints, versioning, rate limiting\n   * **Extended Features** (via features+=):\n     - **GraphQL**: Schema definition, resolvers, subscriptions\n     - **i18n**: Locale files, translation keys, RTL support\n     - **Analytics**: GA4, Mixpanel, custom event tracking\n     - **Monitoring**: OpenTelemetry, error tracking, APM\n   * **Community Plugins**: Register via SQLite, auto-discover\n\n6. **Development Tools Configuration**\n   * Version control: `.gitignore`, `.gitattributes`, README.md\n   * Code quality: ESLint, Prettier, pre-commit hooks\n   * Environment: `.env.development`, `.env.test`, `.env.production`, `.env.example`\n   * Docker: Multi-stage Dockerfile, docker-compose variants\n   * CI/CD: Stack-specific GitHub Actions workflows\n   * Security: Dependabot, secret scanning, SAST tools (if security=true)\n\n6. **Documentation Generation**\n   * **README.md**: Project overview, setup instructions, usage examples\n   * **CONTRIBUTING.md**: Development guidelines, code style, PR process\n   * **API Documentation**: Auto-generated API docs based on stack\n   * **Architecture Diagram**: High-level system design explanation\n\n7. **Deployment Configuration**\n   * **Vercel**: vercel.json, environment variables setup\n   * **Netlify**: netlify.toml, build configuration\n   * **AWS**: CloudFormation templates, deployment scripts\n   * **Docker**: Multi-stage Dockerfile, docker-compose for development\n   * **Render**: render.yaml, environment groups, preview environments\n\n8. **Stack-Specific CI/CD Templates**\n   * **Node.js stacks**: `.github/workflows/node-test.yml`, `node-lint.yml`\n   * **Svelte/Astro/Remix/Vite**: `.github/workflows/node-test.yml` with framework-specific builds\n   * **Python stacks**: `.github/workflows/python-django.yml`, `python-fastapi.yml`\n   * **Go**: `.github/workflows/go-ci.yml` with `go vet`, `go test`\n   * **Flutter**: `.github/workflows/flutter-ci.yml` with analyze/test\n   * **Deployment**: `deploy-vercel.yml`, `deploy-aws.yml`, `docker-build.yml`\n\n9. **Knowledge Base and Templates**\n   * Store successful configurations in memory/SQLite\n   * Track stack/deployment compatibility matrix\n   * Learn from common patterns and successful combinations\n   * Update SQLite with project metadata and success metrics\n\n10. **Post-Setup Verification & Smoke Tests**\n    * **Node.js (React/Vue/Next.js)**: Run `npm install && npm run build && npm test`\n    * **Svelte**: Run `npm install && npm run check && npm run build`\n    * **Astro**: Run `npm install && npm run build`\n    * **Remix**: Run `npm install && npm run build && npm run typecheck`\n    * **Vite**: Run `npm install && npm run build`\n    * **Python**: Run `pip install -r requirements.txt && pytest`\n    * **Go**: Run `go mod download && go vet ./... && go test ./...`\n    * **Flutter**: Run `flutter pub get && flutter analyze`\n    * Fail fast with actionable error logs\n    * Generate setup verification report\n\n11. **Documentation Generation**\n    * **Architecture Diagrams**: Mermaid-based system diagrams\n    * **API Docs**: Swagger/OpenAPI for REST, GraphQL schemas\n    * **Stack-specific**: TSDoc for TypeScript, GoDoc for Go\n    * **README**: Include quickstart, architecture, deployment guides\n\n> 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.","contentHash":"3740c9421e4a91092a6576b3ccb151da47143d70a2ba45edc5da5e1c49496f22","copies":5,"createdAt":"2025-07-22T16:25:40.796Z","description":"Production-grade project bootstrapper with security-first practices, validated configurations, and comprehensive testing","github":{"lastSyncDirection":"from-github","lastSyncError":"Failed to sync YAML command: Failed to extract file contents: logger.logProgress is not a function","repoUrl":"https://github.com/Commands-com/ai-commands","metadata":{"importedFrom":"github_repository","repoPrivate":true,"repoDefaultBranch":"main","connectedAt":"2025-07-22T16:25:40.796Z"},"importedAt":"2025-07-22T16:25:40.796Z","lastSyncAt":"2025-08-17T16:56:09.723Z","fileMapping":{"license":"LICENSE","readme":"project-setup/README.md","assets":[],"mainFile":"project-setup/command.md"},"selectedCommand":"project-setup","fileShas":{"mainFile":"34ae30f4985754011795b5cc6d51f07cc9f5564d","yamlPath":"4507cfda9afa7474437ab79914331e61ec82f4f7","readme":"05c2beb1133822413dc3c5a1c895c20dcab2ba0d"},"branch":"main","connectionType":"commands_yaml","connected":true,"lastSyncCommit":"3f1460bda072265aa9ad932490481f0843dc66f8","importSource":"repository_import","installationId":"69232615","syncStatus":"synced"},"githubRepoUrl":"https://github.com/Commands-com/ai-commands","id":"96e6c63f-8613-4852-a616-15efce87a45f","inputParameters":[{"name":"name","description":"Name for the new project (will be used for directory and package name)","label":"Project Name","type":"text","required":true,"defaultValue":""},{"defaultValue":"react","name":"stack","options":["react","vue","nextjs","svelte","astro","remix","vite","express","fastapi","django","go-api","flutter"],"description":"Primary technology stack for the project","label":"Technology Stack","type":"select","required":true},{"defaultValue":"none","name":"deployment","options":["vercel","netlify","aws","docker","render","none"],"description":"Target deployment platform (validates stack compatibility)","label":"Deployment Target","type":"select","required":false},{"name":"features","description":"Comma-separated list of features (extensible via plugins)","label":"Features","type":"text","required":false,"defaultValue":"testing"},{"defaultValue":"mit","name":"license","options":["mit","apache","gpl","bsd3","mpl2"],"description":"Open source license for the project","label":"License Type","type":"select","required":false},{"defaultValue":"false","name":"security","options":["true","false"],"description":"Add security scanning, secret management, and compliance tools","label":"Enable Security Features","type":"select","required":false}],"instructions":"# Project Scaffolder\n\nProduction-grade project bootstrapper that creates complete development environments with security-first practices and validated configurations. Supports multiple tech stacks with stack-specific CI/CD pipelines and comprehensive smoke testing.\n\n## Key Features:\n- **Smart Validation**: Prevents invalid stack/deployment combinations (e.g., Flutter + Vercel)\n- **Security Layer**: Optional security scanning, secret management, and compliance tools\n- **Environment Abstraction**: Separate configs for development, test, and production\n- **Pluggable Features**: Core features plus extensible community plugins\n- **Stack-Specific CI/CD**: Tailored GitHub Actions workflows for each technology\n- **Automated Testing**: Post-setup smoke tests ensure everything works\n- **Learning System**: Builds knowledge base from successful project patterns\n\n## How to Use:\n1. **Project Name**: Enter the name for your new project (used for directory and package naming)\n2. **Technology Stack**: Choose your primary tech stack:\n   - **Frontend**: React, Vue, Next.js, Svelte, Astro, Remix, Vite\n   - **Backend**: Express, FastAPI, Django, Go API\n   - **Mobile**: Flutter\n3. **Deployment Target**: Select deployment platform (Vercel, Netlify, AWS, Docker, Render, or none)\n4. **Features**: Specify comma-separated features (auth, database, testing, api, graphql, i18n, analytics)\n5. **License**: Choose the open source license (MIT, Apache 2.0, GPL, BSD-3, MPL-2.0)\n6. **Security**: Enable security-first configuration with Dependabot, SAST, and secret scanning\n\n## What It Creates:\n- Complete project directory structure with best practices\n- Stack-specific configuration files (tsconfig, go.mod, pubspec.yaml, etc.)\n- Multiple environment files (.env.development, .env.test, .env.production)\n- Git initialization with comprehensive .gitignore\n- Stack-specific CI/CD workflows (node-test.yml, python-django.yml, go-ci.yml)\n- Architecture documentation with Mermaid diagrams\n- API documentation (Swagger/OpenAPI for REST, GraphQL schemas)\n- Security configurations (if enabled): Dependabot, secret scanning, SAST\n- Post-setup verification with automated smoke tests\n\n## Stack Compatibility Matrix:\n| Stack | Vercel | Netlify | AWS | Docker | Render |\n|-------|--------|---------|-----|--------|--------|\n| React | ✅ | ✅ | ✅ | ✅ | ✅ |\n| Vue | ✅ | ✅ | ✅ | ✅ | ✅ |\n| Next.js | ✅ | ✅ | ✅ | ✅ | ✅ |\n| Svelte | ✅ | ✅ | ✅ | ✅ | ✅ |\n| Astro | ✅ | ✅ | ✅ | ✅ | ✅ |\n| Remix | ✅ | ✅ | ✅ | ✅ | ✅ |\n| Vite | ✅ | ✅ | ✅ | ✅ | ✅ |\n| Express | ❌ | ⚠️* | ✅ | ✅ | ✅ |\n| FastAPI | ❌ | ❌ | ✅ | ✅ | ✅ |\n| Django | ❌ | ❌ | ✅ | ✅ | ✅ |\n| Go API | ❌ | ❌ | ✅ | ✅ | ✅ |\n| Flutter | ❌ | ❌ | ✅ | ✅ | ❌ |\n\n*Express on Netlify requires Functions configuration\n\n## Prerequisites:\n- Filesystem MCP server for creating project structure and files\n- GitHub MCP server for repository initialization and workflows\n- Memory MCP server for tracking project templates and best practices\n- SQLite MCP server for storing project configurations and templates\n\n## Example Commands:\n```bash\n# Basic React app with testing\n/project-setup name=\"my-app\" stack=react\n\n# Production Next.js with all features and security\n/project-setup name=\"saas-platform\" stack=nextjs deployment=vercel features=auth,database,testing,api,analytics security=true\n\n# Modern Svelte app with Vercel deployment\n/project-setup name=\"svelte-app\" stack=svelte deployment=vercel features=auth,testing\n\n# Static site with Astro\n/project-setup name=\"blog\" stack=astro deployment=netlify features=i18n,analytics\n\n# Full-stack Remix app\n/project-setup name=\"remix-app\" stack=remix deployment=render features=auth,database,api,testing\n\n# Vanilla TypeScript with Vite\n/project-setup name=\"ts-app\" stack=vite features=testing\n\n# Django API with Docker deployment\n/project-setup name=\"api-service\" stack=django deployment=docker features=database,api,testing\n\n# Flutter app with basic features\n/project-setup name=\"mobile-app\" stack=flutter deployment=none features=testing\n```","lastCopied":"2025-12-14T22:04:34.929Z","licenseType":"mit","likes":0,"mcpRequirements":[{"tier":"required","serverId":"filesystem"},{"tier":"required","serverId":"github"},{"tier":"required","serverId":"memory"},{"tier":"required","serverId":"sqlite"}],"mcp_search_content":"docker-filesystem docker-github docker-memory docker-sqlite","organizationUsername":"commands-com","price":"free","processedGalleryItems":[{"s3KeyThumbnail":"processed/96e6c63f-8613-4852-a616-15efce87a45f/1753201541199_preview_thumb.webp","s3KeyLarge":"processed/96e6c63f-8613-4852-a616-15efce87a45f/1753201541199_preview.webp","name":"1753201541199_preview.webp","originalKey":"temp-uploads/96e6c63f-8613-4852-a616-15efce87a45f/1753201541199_preview.png","pathLarge":"96e6c63f-8613-4852-a616-15efce87a45f/1753201541199_preview.webp","type":"image/webp","pathThumbnail":"96e6c63f-8613-4852-a616-15efce87a45f/1753201541199_preview_thumb.webp"}],"search_content":"project scaffolder production-grade project bootstrapper with security-first practices, validated configurations, and comprehensive testing /project-setup development claude-code@2025.06","title":"Project Scaffolder","type":"command","updatedAt":"2025-08-17T16:56:09.723Z","userId":"W0V8NAw5AhWRwcuwSoFLOi1Yem83","visibility":"public","name":"project-setup","userInteraction":{"userHasStarred":false}}