ai-flow-dev 1.2.0 → 1.3.0

package/README.md

@@ -10,7 +10,7 @@ AI Flow is an interactive CLI that creates comprehensive professional documentat
 
 **Key Features:**
 
-- 🚀 Complete professional documentation (Backend: 13 docs, Frontend: 15+ docs, Mobile: 11+ docs, Fullstack: 20+ docs)
+- 🚀 Complete professional documentation (Backend: 17 docs, Frontend: 15 docs, Mobile: 14 docs, Fullstack: 4+ docs)
 - ⚡ **Two modes:** Interactive (90-120 min, full control) or Smart Auto-Suggest (15-25 min, 6 questions)
 - 🌍 Universal support - 12 languages, 60+ frameworks, 35+ ORMs (98% coverage)
 - 🤖 Multi-AI support with slash commands
@@ -19,6 +19,8 @@ AI Flow is an interactive CLI that creates comprehensive professional documentat
 
 **Quick Start:**
 
+**Requirements:** Node.js ≥20.0.0
+
 ```bash
 npm install -g ai-flow-dev
 ai-flow init .
@@ -35,7 +37,7 @@ Transforma tu idea en un proyecto listo para producción y documentado para IA e
 
 **Características:**
 
-- 🚀 Documentación profesional completa (Backend: 13 docs, Frontend: 15+ docs, Mobile: 11+ docs, Fullstack: 20+ docs)
+- 🚀 Documentación profesional completa (Backend: 17 docs, Frontend: 15 docs, Mobile: 14 docs, Fullstack: 4+ docs)
 - ⚡ **Dos modos:** Interactivo (90-120 min, control total) o Auto-Sugerido (15-25 min, 6 preguntas)
 - 🌍 Soporte universal - 12 lenguajes, 60+ frameworks, 35+ ORMs
 - 🤖 Compatible con Claude, Copilot, Cursor, Gemini
@@ -44,6 +46,8 @@ Transforma tu idea en un proyecto listo para producción y documentado para IA e
 
 **Inicio rápido:**
 
+**Requisitos:** Node.js ≥20.0.0
+
 ```bash
 npm install -g ai-flow-dev
 ai-flow init .
@@ -59,7 +63,7 @@ ai-flow init .
 Transforme sua ideia em um projeto pronto para produção e documentado para IA em minutos.
 **Características:**
 
-- 🚀 Documentação profissional completa (14-17 docs por tipo)
+- 🚀 Documentação profissional completa (Backend: 17, Frontend: 15, Mobile: 14, Fullstack: 4+ docs)
 - ⚡ **Dois modos:** Interativo (90-120 min, controle total) ou Auto-Sugestão (15-25 min, 6 perguntas)
 - 🌍 Suporte universal - 12 linguagens, 60+ frameworks, 35+ ORMs
 - 🤖 Compatível com Claude, Copilot, Cursor, Gemini
@@ -69,6 +73,8 @@ Transforme sua ideia em um projeto pronto para produção e documentado para IA
 
 **Início Rápido:**
 
+**Requisitos:** Node.js ≥20.0.0
+
 ```bash
 npm install -g ai-flow-dev
 ai-flow init .
@@ -97,7 +103,7 @@ The result is interconnected documentation that guides AI assistants and human d
 
 - 🌍 **Universal Support** - 12 languages, 60+ frameworks, 35+ ORMs (98% coverage)
 - 🤖 **AI-Agnostic** - Claude, Copilot, Cursor, Gemini, any AI tool
-- 📚 **Professional Documentation** - 14-17 docs per project type
+- 📚 **Professional Documentation** - Backend: 17, Frontend: 15, Mobile: 14, Fullstack: 4+ docs
 - ⚡ **Two Questionnaire Modes:**
   - **Interactive Mode:** Full control, 71 questions (90-120 min)
   - **Smart Auto-Suggest:** Only 6 critical questions, AI suggests best practices (15-25 min)
@@ -167,8 +173,8 @@ ai-flow --help          # Show help
 --type <type>            # backend, frontend, mobile, fullstack (interactive if omitted)
 --name <name>            # Project name (interactive if omitted)
 --description <desc>     # Project description (interactive if omitted)
---verbose                # Detailed logging
---dry-run                # Simulate without writing
+--verbose                # Detailed logging (init only)
+--dry-run                # Simulate without writing (init only)
 ```
 
 **Examples:**
@@ -276,7 +282,7 @@ After initialization, use these slash commands in your AI tool:
 
 1. **Smart Detection** - Analyzes existing projects in 3 layers (15s to 5min)
 2. **Interactive Questionnaire** - Guides you through 8-9 phases (choose mode)
-3. **Template Generation** - Creates 14-17 professional documents
+3. **Template Generation** - Creates 15-17 professional documents per project type
 4. **Implementation Roadmap** - Optional Phase 9 generates Story Point estimates
 5. **AI Integration** - Configures your AI tool with project context
 6. **Slash Command Setup** - Installs prompts to tool-specific paths (.github/prompts/, .claude/commands/, etc.)
@@ -304,7 +310,7 @@ After initialization, use these slash commands in your AI tool:
 
 **Mobile** (14 docs): AGENT.md, ai-instructions.md, project-brief.md, README.md, 8 technical docs, 2 specs
 
-**Fullstack** (~20 docs): Merges backend + frontend templates with priority resolution (fullstack-specific → backend → frontend)
+**Fullstack** (4+ docs): ai-instructions.md, project-brief.md, README.md, configuration spec + inherits from backend/frontend as needed
 
 ---
 

package/dist/cli.js

@@ -649,7 +649,7 @@ async function initializeProject(targetPath, aiTool, projectType, projectName, p
 program
     .name('ai-flow')
     .description('AI-powered development workflow from idea to production. Generate specs, plan features, and build with AI assistance.')
-    .version('1.2.0');
+    .version('1.3.0');
 program
     .command('init')
     .description('Initialize AI Flow in current directory')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-flow-dev",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "AI-powered development workflow from idea to production. Generate specs, plan features, and build with AI assistance throughout your project lifecycle.",
   "type": "module",
   "main": "dist/cli.js",

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

@@ -212,6 +212,614 @@ You can initialize manually later with:
 Proceeding to documentation generation...
 ```
 
+### 8.2.6: Complete Project Structure Setup
+
+**Set up complete development environment based on framework from Phase 3:**
+
+```
+🔧 Setting up complete development environment...
+
+Framework detected: [FRAMEWORK_NAME]
+Creating additional configurations according to documentation:
+```
+
+**Based on the selected framework and ORM/database from previous phases:**
+
+**Install latest stable NestJS dependencies:**
+
+```bash
+# Install NestJS CLI globally (latest stable)
+npm install -g @nestjs/cli
+
+# Initialize with latest stable dependencies
+npm install @nestjs/common @nestjs/core @nestjs/platform-express
+npm install @nestjs/config @nestjs/jwt @nestjs/passport @nestjs/swagger
+npm install @prisma/client bcrypt class-transformer class-validator
+npm install passport passport-jwt passport-local reflect-metadata rxjs swagger-ui-express
+
+# Install development dependencies (latest stable)
+npm install -D @nestjs/cli @nestjs/schematics @nestjs/testing
+npm install -D @types/bcrypt @types/express @types/jest @types/node
+npm install -D @types/passport-jwt @types/passport-local @types/supertest
+npm install -D @typescript-eslint/eslint-plugin @typescript-eslint/parser
+npm install -D eslint eslint-config-prettier eslint-plugin-prettier
+npm install -D jest prettier prisma source-map-support supertest
+npm install -D ts-jest ts-loader ts-node tsconfig-paths typescript
+```
+
+**Update package.json scripts:**
+
+```json
+{
+  "scripts": {
+    "build": "nest build",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "start": "nest start",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
+    "test:e2e": "jest --config ./test/jest-e2e.json",
+    "db:generate": "prisma generate",
+    "db:push": "prisma db push",
+    "db:migrate": "prisma migrate dev",
+    "db:studio": "prisma studio"
+  }
+}
+```
+
+**Create enhanced tsconfig.json:**
+
+```json
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2021",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "noImplicitAny": true,
+    "strictBindCallApply": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "paths": {
+      "@/*": ["src/*"],
+      "@/common/*": ["src/common/*"],
+      "@/config/*": ["src/config/*"]
+    }
+  }
+}
+```
+
+**Create complete Prisma configuration:**
+
+```prisma
+// prisma/schema.prisma
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+// Basic User model (additional entities will be added in development phases)
+model User {
+  id        Int      @id @default(autoincrement())
+  email     String   @unique
+  name      String?
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@map("users")
+}
+```
+
+**Create .env file:**
+
+```env
+# Database
+DATABASE_URL="postgresql://postgres:password@localhost:5432/myapp_dev?schema=public"
+
+# JWT
+JWT_SECRET="your-super-secret-jwt-key-change-in-production"
+JWT_EXPIRES_IN="24h"
+
+# App
+NODE_ENV="development"
+PORT=3000
+
+# Cors
+CORS_ORIGIN="http://localhost:3000"
+```
+
+**Create docker-compose.yml for PostgreSQL:**
+
+```yaml
+version: "3.8"
+services:
+  postgres:
+    image: postgres:15-alpine
+    restart: always
+    environment:
+      POSTGRES_DB: myapp_dev
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: password
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+
+volumes:
+  postgres_data:
+```
+
+**Create complete ESLint + Prettier configuration:**
+
+```json
+// .eslintrc.js
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: 'tsconfig.json',
+    tsconfigRootDir: __dirname,
+    sourceType: 'module',
+  },
+  plugins: ['@typescript-eslint/eslint-plugin'],
+  extends: [
+    '@nestjs',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended',
+  ],
+  root: true,
+  env: {
+    node: true,
+    jest: true,
+  },
+  ignorePatterns: ['.eslintrc.js'],
+  rules: {
+    '@typescript-eslint/interface-name-prefix': 'off',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+  },
+};
+```
+
+```json
+// .prettierrc
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "tabWidth": 2,
+  "semi": true,
+  "printWidth": 80
+}
+```
+
+**Update main.ts with complete configuration:**
+
+```typescript
+import { NestFactory } from "@nestjs/core";
+import { ValidationPipe } from "@nestjs/common";
+import { SwaggerModule, DocumentBuilder } from "@nestjs/swagger";
+import { AppModule } from "./app.module";
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  // Global validation pipe
+  app.useGlobalPipes(
+    new ValidationPipe({
+      whitelist: true,
+      forbidNonWhitelisted: true,
+      transform: true,
+    })
+  );
+
+  // CORS
+  app.enableCors({
+    origin: process.env.CORS_ORIGIN || "http://localhost:3000",
+    credentials: true,
+  });
+
+  // Swagger API Documentation
+  const config = new DocumentBuilder()
+    .setTitle("API Documentation")
+    .setDescription("The API description")
+    .setVersion("1.0")
+    .addBearerAuth()
+    .build();
+  const document = SwaggerModule.createDocument(app, config);
+  SwaggerModule.setup("api/docs", app, document);
+
+  const port = process.env.PORT || 3000;
+  await app.listen(port);
+  console.log(`🚀 Application is running on: http://localhost:${port}`);
+  console.log(`📚 Swagger documentation: http://localhost:${port}/api/docs`);
+}
+bootstrap();
+```
+
+**Create basic folder structure:**
+
+```
+src/
+├── common/
+│   ├── decorators/
+│   ├── filters/
+│   ├── guards/
+│   ├── interceptors/
+│   └── pipes/
+├── config/
+│   ├── database.config.ts
+│   └── jwt.config.ts
+└── health/
+    ├── health.controller.ts
+    └── health.module.ts
+```
+
+**IMPORTANT: Do NOT create entity-specific modules** (User, Product, Order, etc.)
+**Only create the basic NestJS structure with configurations**
+
+```
+✅ Complete NestJS development environment ready!
+✅ PostgreSQL configured with Docker Compose
+✅ Prisma ORM configured with basic User model
+✅ ESLint + Prettier configured
+✅ JWT authentication structure ready
+✅ Swagger API documentation enabled
+✅ All development scripts configured
+
+🎯 Project is ready for development - entity modules should be created during development phases
+```
+
+**Install dependencies:**
+
+```bash
+npm install
+
+# Generate Prisma client
+npx prisma generate
+
+# Start database
+docker-compose up -d
+
+# Run migrations (creates User table)
+npx prisma db push
+```
+
+```
+🔄 Installing dependencies...
+📦 Generating Prisma client...
+🐘 Starting PostgreSQL container...
+🗄️  Creating database tables...
+
+✅ All configurations applied successfully!
+
+Next steps for development:
+1. Start development server: npm run start:dev
+2. Open API docs: http://localhost:3000/api/docs
+3. Access database: npx prisma studio
+4. Create entity modules as needed during development
+```
+
+#### **FastAPI (Python) Complete Setup:**
+
+**Install latest stable dependencies:**
+
+```bash
+# Install latest stable FastAPI and dependencies
+pip install fastapi uvicorn[standard] sqlalchemy alembic psycopg2-binary
+pip install python-jose[cryptography] passlib[bcrypt] python-multipart
+pip install pydantic pydantic-settings
+
+# Install development dependencies (latest stable)
+pip install pytest pytest-asyncio black flake8 mypy
+```
+
+**Create requirements.txt (use after installation to lock versions):**
+
+```bash
+pip freeze > requirements.txt
+```
+
+**Create complete project structure:**
+
+```
+app/
+├── __init__.py
+├── main.py
+├── core/
+│   ├── __init__.py
+│   ├── config.py
+│   ├── security.py
+│   └── database.py
+├── api/
+│   ├── __init__.py
+│   └── deps.py
+├── models/
+│   ├── __init__.py
+│   └── user.py
+└── schemas/
+    ├── __init__.py
+    └── user.py
+```
+
+**Create docker-compose.yml:**
+
+```yaml
+version: "3.8"
+services:
+  postgres:
+    image: postgres:15-alpine
+    environment:
+      POSTGRES_DB: myapp_dev
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: password
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+
+volumes:
+  postgres_data:
+```
+
+#### **Express.js (Node.js) Complete Setup:**
+
+**Install latest stable dependencies:**
+
+```bash
+# Install production dependencies (latest stable)
+npm install express cors helmet express-rate-limit jsonwebtoken bcrypt @prisma/client dotenv
+
+# Install development dependencies (latest stable)
+npm install -D @types/express @types/cors @types/bcrypt @types/jsonwebtoken
+npm install -D typescript nodemon ts-node jest @types/jest prisma
+
+# Update package.json scripts
+```
+
+**Configure package.json scripts:**
+
+```json
+{
+  "scripts": {
+    "dev": "nodemon src/app.ts",
+    "build": "tsc",
+    "start": "node dist/app.js",
+    "lint": "eslint src/**/*.ts",
+    "test": "jest",
+    "db:generate": "prisma generate",
+    "db:migrate": "prisma migrate dev"
+  }
+}
+```
+
+#### **Django (Python) Complete Setup:**
+
+**Install latest stable dependencies:**
+
+```bash
+# Install Django and DRF (latest stable)
+pip install Django djangorestframework django-cors-headers
+pip install celery redis psycopg2-binary python-decouple
+pip install djangorestframework-simplejwt django-filter
+
+# Create requirements.txt after installation
+pip freeze > requirements.txt
+```
+
+**Create settings structure:**
+
+```
+config/
+├── __init__.py
+├── settings/
+│   ├── __init__.py
+│   ├── base.py
+│   ├── development.py
+│   └── production.py
+├── urls.py
+└── wsgi.py
+```
+
+#### **Spring Boot (Java) Complete Setup:**
+
+**Create Spring Boot project with latest stable dependencies:**
+
+```bash
+# Use Spring Initializr or Spring Boot CLI for latest stable versions
+spring init --dependencies=web,data-jpa,security,postgresql --build=maven .
+
+# Or add dependencies manually (latest stable versions)
+```
+
+**Add JWT dependency to pom.xml:**
+
+```xml
+<dependencies>
+    <!-- Spring Boot starters (managed versions) -->
+    <dependency>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+    <dependency>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-data-jpa</artifactId>
+    </dependency>
+    <dependency>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-security</artifactId>
+    </dependency>
+    <dependency>
+        <groupId>org.postgresql</groupId>
+        <artifactId>postgresql</artifactId>
+    </dependency>
+    <!-- Use latest stable JWT library -->
+    <dependency>
+        <groupId>io.jsonwebtoken</groupId>
+        <artifactId>jjwt-api</artifactId>
+    </dependency>
+    <dependency>
+        <groupId>io.jsonwebtoken</groupId>
+        <artifactId>jjwt-impl</artifactId>
+        <scope>runtime</scope>
+    </dependency>
+    <dependency>
+        <groupId>io.jsonwebtoken</groupId>
+        <artifactId>jjwt-jackson</artifactId>
+        <scope>runtime</scope>
+    </dependency>
+</dependencies>
+```
+
+#### **Laravel (PHP) Complete Setup:**
+
+**Install Laravel with latest stable version:**
+
+```bash
+# Create Laravel project with latest stable version
+composer create-project laravel/laravel .
+
+# Install additional packages (latest stable)
+composer require laravel/sanctum
+composer require --dev laravel/pint
+```
+
+**Create .env configuration:**
+
+```env
+DB_CONNECTION=pgsql
+DB_HOST=127.0.0.1
+DB_PORT=5432
+DB_DATABASE=myapp_dev
+DB_USERNAME=postgres
+DB_PASSWORD=password
+
+SANCTUM_STATEFUL_DOMAINS=localhost:3000
+SESSION_DOMAIN=localhost
+```
+
+#### **Go (Gin Framework) Complete Setup:**
+
+**Initialize Go module and install dependencies:**
+
+```bash
+# Initialize Go module
+go mod init myapp
+
+# Install latest stable dependencies
+go get github.com/gin-gonic/gin
+go get github.com/golang-jwt/jwt/v5
+go get gorm.io/gorm
+go get gorm.io/driver/postgres
+go get github.com/golang-migrate/migrate/v4
+go get github.com/go-playground/validator/v10
+
+# Tidy dependencies
+go mod tidy
+```
+
+**Generated go.mod will use latest compatible versions**
+
+**Create basic structure:**
+
+```
+cmd/
+├── server/
+│   └── main.go
+internal/
+├── config/
+├── handlers/
+├── middleware/
+├── models/
+└── services/
+pkg/
+└── database/
+```
+
+#### **Ruby on Rails Complete Setup:**
+
+**Create new Rails project and install dependencies:**
+
+```bash
+# Create new Rails API project
+rails new myapp --api --skip-git --database=postgresql
+
+# Navigate to project
+cd myapp
+
+# Install latest stable gems
+bundle add jwt
+bundle add bcrypt
+bundle add rack-cors
+bundle add rspec-rails --group development,test
+bundle add factory_bot_rails --group development,test
+bundle add byebug --group development,test
+
+# Install all dependencies
+bundle install
+```
+
+**Generated Gemfile will use latest compatible versions**
+
+#### **.NET Core Complete Setup:**
+
+**Create project and install latest stable packages:**
+
+```bash
+# Create new Web API project
+dotnet new webapi -n MyApp
+cd MyApp
+
+# Install latest stable Entity Framework packages
+dotnet add package Microsoft.EntityFrameworkCore.Design
+dotnet add package Microsoft.EntityFrameworkCore.Tools
+dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL
+
+# Install latest authentication packages
+dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer
+
+# Restore packages
+dotnet restore
+```
+
+**IMPORTANT FOR ALL FRAMEWORKS:**
+
+- **DO NOT create entity-specific controllers/routes** (users, products, orders, etc.)
+- **Only create basic project structure with configurations**
+- **Authentication structure ready but no specific endpoints**
+- **Database configured with basic table (if ORM used)**
+- **All development tools configured (linting, testing, etc.)**
+
+```
+✅ Complete [FRAMEWORK] development environment ready!
+✅ Database configured with Docker Compose
+✅ ORM/Database layer configured
+✅ Authentication structure ready
+✅ API documentation configured (where applicable)
+✅ Linting and formatting configured
+✅ Testing framework configured
+✅ All development scripts configured
+
+🎯 Project ready for development - entity-specific modules/controllers should be created during development phases
+```
+
 ---
 
 ## 8.3: Generate Final Documentation
@@ -908,4 +1516,3 @@ Happy coding! 🚀
 
 **SUCCESS:** Project fully documented and ready for development! 🚀
 ```
-

package/templates/shared/AGENT.template.md

@@ -249,4 +249,4 @@ See `README.md` for installation and setup instructions.
 
 **Last Updated:** {{GENERATION_DATE}}
 
-**Generated by:** AI Flow v1.2.0
+**Generated by:** AI Flow v1.3.0