ai-flow-dev 1.2.0 → 1.4.0

package/prompts/backend/flow-bootstrap-phase-8.md

@@ -103,69 +103,97 @@ Backup complete! Safe to initialize framework.
 
 ### 8.2.3: Execute Framework CLI
 
-**Based on framework detected in Phase 3:**
+**IMPORTANT:** Use Bash tool to execute the framework's official CLI command. This ensures the project gets the latest stable versions and official project structure.
 
-**Node.js frameworks:**
+**Based on framework detected in Phase 3, execute ONE of these commands:**
+
+**NestJS:**
 
 ```bash
-# NestJS
 npx @nestjs/cli new . --skip-git --package-manager npm
+```
+
+**Express:**
 
-# Express (using express-generator)
-npx express-generator . --no-view --git
+```bash
+# Initialize package.json
+npm init -y
+
+# Install core dependencies with latest versions
+npm install express cors helmet dotenv
 
-# Fastify
-npm init fastify
+# Install dev dependencies
+npm install -D typescript @types/node @types/express ts-node nodemon
 
-# Next.js
-npx create-next-app@latest . --typescript --eslint --tailwind --app --src-dir --import-alias "@/*"
+# Create src/app.ts from template (see section 8.2.6.4)
 ```
 
-**Python frameworks:**
+**Django:**
 
 ```bash
-# Django
 django-admin startproject config .
+```
+
+**FastAPI:**
+
+```bash
+# Install FastAPI with latest stable
+pip install "fastapi[standard]" uvicorn[standard]
+
+# Create app/main.py from template (see section 8.2.6.4)
+```
+
+**Spring Boot:**
 
-# FastAPI
-# Create main.py, requirements.txt, project structure
-mkdir -p app/api app/models app/schemas app/services
-touch main.py requirements.txt
-# Generate starter files
+```bash
+spring init --dependencies=web,data-jpa --build=maven --name=[ProjectName] .
+```
+
+**Laravel:**
 
-# Flask
-flask init
+```bash
+composer create-project laravel/laravel .
 ```
 
-**Other frameworks:**
+**Go (Gin):**
 
 ```bash
-# Go
 go mod init [module-name]
+go get -u github.com/gin-gonic/gin
+```
 
-# .NET
-dotnet new webapi -n [ProjectName]
+**Ruby on Rails:**
 
-# Ruby on Rails
-rails new . --api --skip-git
+```bash
+rails new . --api --skip-git --database=postgresql
+```
 
-# PHP Laravel
-composer create-project laravel/laravel .
+**.NET Core:**
 
-# Java Spring Boot
-spring init --dependencies=web,data-jpa --build=maven .
+```bash
+dotnet new webapi -n [ProjectName] -o .
 ```
 
-**Show progress:**
+**Show progress as command executes:**
 
 ```
-🚀 Initializing [FRAMEWORK_NAME]...
+🚀 Executing: npx @nestjs/cli new . --skip-git
 
-[Framework CLI output]
+[Real CLI output from Bash tool]
 
 ✅ Framework initialized successfully!
 ```
 
+**Result:** Framework CLI creates:
+
+- ✅ package.json / requirements.txt / pom.xml (with latest versions)
+- ✅ tsconfig.json / pyproject.toml (optimized configs)
+- ✅ Basic src/ structure
+- ✅ Test setup
+- ✅ Linting/formatting configs
+
+**Next:** Only add what framework doesn't include (see 8.2.6)
+
 ### 8.2.4: Restore AI Flow Documentation
 
 ```
@@ -212,6 +240,235 @@ You can initialize manually later with:
 Proceeding to documentation generation...
 ```
 
+### 8.2.6: Minimal Post-Init Enhancements
+
+**IMPORTANT:** Only add what the framework CLI doesn't include. **DO NOT** create business logic, entity modules, or complete features.
+
+```
+📦 Adding minimal enhancements...
+
+Framework base created by CLI ✅
+Now adding only essential files that framework doesn't include...
+```
+
+**Based on selected framework and database from previous phases:**
+
+### 8.2.6.1: Environment Variables Template
+
+**Copy `.env.example` template to project root:**
+
+```bash
+# Copy from .ai-flow/templates/.env.example.template to .env.example
+```
+
+**Template content (adapt based on framework and database):**
+
+```env
+# Database
+DATABASE_URL="postgresql://postgres:password@localhost:5432/{{PROJECT_NAME}}_dev?schema=public"
+
+# JWT Authentication
+JWT_SECRET="your-secret-key-here-change-in-production"
+JWT_EXPIRES_IN="24h"
+
+# Application
+NODE_ENV="development"
+PORT=3000
+API_PREFIX="/api"
+
+# CORS
+CORS_ORIGIN="http://localhost:3000"
+
+# Redis (if using)
+REDIS_HOST="localhost"
+REDIS_PORT=6379
+
+# Email (if using)
+SMTP_HOST=""
+SMTP_PORT=587
+SMTP_USER=""
+SMTP_PASS=""
+```
+
+**User must copy to `.env` manually:**
+
+```
+📝 Created .env.example template
+⚠️  User must copy to .env and configure: cp .env.example .env
+```
+
+### 8.2.6.2: Docker Compose (Optional)
+
+**Only if user selected Docker in Phase 7.**
+
+**Copy appropriate docker-compose template based on database:**
+
+**PostgreSQL:**
+
+```yaml
+# Copy from templates/docker-compose/postgres.template.yml
+version: "3.8"
+
+services:
+  postgres:
+    image: postgres:15-alpine
+    restart: unless-stopped
+    environment:
+      POSTGRES_DB: ${DB_NAME:-myapp_dev}
+      POSTGRES_USER: ${DB_USER:-postgres}
+      POSTGRES_PASSWORD: ${DB_PASSWORD:-password}
+    ports:
+      - "${DB_PORT:-5432}:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  postgres_data:
+```
+
+**MySQL:**
+
+```yaml
+# Copy from templates/docker-compose/mysql.template.yml
+version: "3.8"
+
+services:
+  mysql:
+    image: mysql:8-oracle
+    restart: unless-stopped
+    environment:
+      MYSQL_DATABASE: ${DB_NAME:-myapp_dev}
+      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD:-password}
+    ports:
+      - "${DB_PORT:-3306}:3306"
+    volumes:
+      - mysql_data:/var/lib/mysql
+
+volumes:
+  mysql_data:
+```
+
+**MongoDB:**
+
+```yaml
+# Copy from templates/docker-compose/mongodb.template.yml
+version: "3.8"
+
+services:
+  mongodb:
+    image: mongo:7
+    restart: unless-stopped
+    environment:
+      MONGO_INITDB_DATABASE: ${DB_NAME:-myapp_dev}
+      MONGO_INITDB_ROOT_USERNAME: ${DB_USER:-root}
+      MONGO_INITDB_ROOT_PASSWORD: ${DB_PASSWORD:-password}
+    ports:
+      - "${DB_PORT:-27017}:27017"
+    volumes:
+      - mongodb_data:/data/db
+
+volumes:
+  mongodb_data:
+```
+
+### 8.2.6.3: ORM Setup (If Framework Doesn't Include)
+
+**Only for frameworks that don't auto-configure ORM:**
+
+**NestJS + Prisma:**
+
+```bash
+npx prisma init
+# Creates prisma/schema.prisma automatically with DATABASE_URL from .env
+```
+
+**Express + Prisma:**
+
+```bash
+npm install prisma @prisma/client
+npx prisma init
+```
+
+**FastAPI + SQLAlchemy:**
+
+```bash
+# SQLAlchemy setup (create app/core/database.py)
+# Follow FastAPI documentation: https://fastapi.tiangolo.com/tutorial/sql-databases/
+```
+
+**Django:**
+
+```bash
+# ORM already configured by django-admin startproject
+# Just configure DATABASE settings in config/settings/base.py
+```
+
+**Result:**
+
+```
+✅ ORM initialized
+✅ schema.prisma created (or equivalent)
+✅ Migrations ready to run
+```
+
+### 8.2.6.4: Starter Files for Express/FastAPI (Optional)
+
+**Only if user needs a basic starting point. Otherwise, skip and let them follow official docs.**
+
+**Express:**
+
+- Create `src/app.ts` with basic Express setup (middleware, health endpoint)
+- Reference: https://expressjs.com/en/starter/hello-world.html
+
+**FastAPI:**
+
+- Create `app/main.py` with basic FastAPI setup (CORS, health endpoint)
+- Reference: https://fastapi.tiangolo.com/tutorial/first-steps/
+
+**Docker Compose (if needed):**
+
+- Reference official Docker Hub documentation:
+  - PostgreSQL: https://hub.docker.com/_/postgres
+  - MySQL: https://hub.docker.com/_/mysql
+  - MongoDB: https://hub.docker.com/_/mongo
+
+### 8.2.6.5: Final Summary
+
+```
+✅ Minimal enhancements complete!
+
+Files created (2-3 max):
+✅ .env.example (environment template)
+✅ docker-compose.yml (if Docker selected)
+✅ prisma/schema.prisma (if Prisma ORM)
+
+🎯 Total: 2-3 files (vs 40-60 files in old approach)
+📚 For Express/FastAPI starter code, refer to official documentation
+
+Next steps:
+1. Copy .env.example to .env and configure
+2. Start database: docker-compose up -d (if applicable)
+3. Run migrations: npm run db:migrate or equivalent
+4. Start dev server: npm run start:dev or equivalent
+5. Create features with /feature command
+```
+
+**CRITICAL RULES:**
+
+- ❌ **DO NOT** create entity modules (User, Product, Order, etc.)
+- ❌ **DO NOT** create controllers/routes for business logic
+- ❌ **DO NOT** create authentication endpoints
+- ❌ **DO NOT** create complete folder structures
+- ❌ **DO NOT** install 40+ packages manually
+- ✅ **ONLY** create .env.example, docker-compose (optional), ORM init
+- ✅ **LET** framework CLI handle structure, configs, dependencies
+- ✅ **REFER** to official docs for starter code when needed
+
 ---
 
 ## 8.3: Generate Final Documentation
@@ -511,7 +768,7 @@ The API will be available at `http://localhost:3000`
 
 ---
 
-## 8.6: Create Tool-Specific Configs
+## 8.7: Create Tool-Specific Configs
 
 **Based on AI tool selection from Phase 3 (question 3.8):**
 
@@ -623,7 +880,7 @@ Generate all three files above.
 
 ---
 
-## 8.7: Final Validation & Success Message
+## 8.8: Final Validation & Success Message
 
 ```
 🔍 Validating all generated files...
@@ -908,4 +1165,3 @@ Happy coding! 🚀
 
 **SUCCESS:** Project fully documented and ready for development! 🚀
 ```
-