ai-flow-dev 2.1.2 → 2.1.4

package/prompts/backend/flow-build-phase-0.md

@@ -6,6 +6,7 @@
 ### 🎯 Objective
 
 Efficiently analyze existing projects using a **layered, incremental approach** that:
+
 - ✅ Minimizes context usage (50-75% reduction)
 - ✅ Supports ALL major backend languages and frameworks
 - ✅ Provides smart caching for instant re-runs
@@ -25,9 +26,7 @@ Layer 3: Selective Deep Analysis (1-5 minutes, ~5,000-25,000 tokens, OPTIONAL)
          ↓
 Result Synthesis & Pre-population
 ```
-
----
-
+---
 ## 0.0 Check for Existing Analysis (Layer 0)
 
 ```
@@ -36,7 +35,7 @@ Result Synthesis & Pre-population
 
 **Actions:**
 
-1. Check if `.ai-flow/analysis.json` exists
+1. Check if `.ai-flow/cache/docs-analysis.json` exists
 2. If exists:
    - Read `analyzedAt` timestamp
    - Read `filesAnalyzed` with their timestamps
@@ -101,9 +100,7 @@ Your choice: __
 
 Proceeding to Layer 1...
 ```
-
----
-
+---
 ## 0.1 Layer 1: Fast Metadata Scan (10-20 seconds)
 
 ```
@@ -402,13 +399,12 @@ Checking for Swift project...
 ✅ Layer 1 Complete (15 seconds)
 
 📦 Project Detected:
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
   Name: [from package.json/composer.json/etc.]
   Language: [TypeScript/Python/PHP/Java/etc.]
   Version: [language version]
   Package Manager: [npm/composer/maven/etc.]
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+---
 🚀 Framework: [Name] v[version]
 🗄️  ORM/Database: [Name] v[version]
 
@@ -419,9 +415,7 @@ Checking for Swift project...
 
 💾 Context Used: ~1,200 tokens
 ⏱️  Time Elapsed: 15s
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+---
 Continue to Layer 2? (Structural analysis - no code reading yet)
 
 A) ✅ Yes - Continue (Recommended)
@@ -432,9 +426,7 @@ Your choice: __ (Auto-continue in 3s)
 ```
 
 **Context Usage:** ~1,000-1,500 tokens
-
----
-
+---
 ## 0.2 Layer 2: Structural Analysis (30-90 seconds)
 
 ```
@@ -448,6 +440,7 @@ This scans directory organization and file counts without reading code.
 **Language-specific directory patterns:**
 
 **Node.js/TypeScript:**
+
 ```
 Scanning directories:
 • src/**/* or app/**/* or lib/**/*
@@ -465,6 +458,7 @@ Counting files by pattern:
 ```
 
 **Python:**
+
 ```
 Scanning directories:
 • app/**/*.py or src/**/*.py
@@ -479,6 +473,7 @@ Counting files by pattern:
 ```
 
 **PHP:**
+
 ```
 Scanning directories:
 • app/**/*.php or src/**/*.php
@@ -492,6 +487,7 @@ Counting files by pattern:
 ```
 
 **Java:**
+
 ```
 Scanning directories:
 • src/main/java/**/*.java
@@ -506,6 +502,7 @@ Counting files by pattern:
 ```
 
 **C#/.NET:**
+
 ```
 Scanning directories:
 • **/*.cs (excluding obj/, bin/)
@@ -520,6 +517,7 @@ Counting files by pattern:
 ```
 
 **Go:**
+
 ```
 Scanning directories:
 • **/*.go (excluding vendor/)
@@ -533,6 +531,7 @@ Counting files by pattern:
 ```
 
 **Ruby:**
+
 ```
 Scanning directories:
 • app/**/*.rb
@@ -559,56 +558,68 @@ Counting files by pattern:
 **Based on detected ORM:**
 
 **Prisma:**
+
 - Read `prisma/schema.prisma`
 - Extract model names only (regex: `model (\w+)`)
 - Count total models
 - Count relationships (count occurrences of `@relation`)
 
 **TypeORM:**
+
 - Glob `*.entity.{ts,js}`
 - Extract entity names from `@Entity()` decorator (regex, no full parsing)
 - Count entities
 
 **Sequelize:**
+
 - Glob `models/**/*.{ts,js}`
 - Count model files
 
 **Mongoose:**
+
 - Glob `*.schema.{ts,js}` or `models/**/*.{ts,js}`
 - Search for `new Schema(` pattern
 - Count schemas
 
 **Django:**
+
 - Read `*/models.py` files
 - Extract class names inheriting from `models.Model` (regex)
 - Count models
 
 **SQLAlchemy:**
+
 - Read `**/models.py` or `**/*_model.py`
 - Extract classes with `Base` or `db.Model` (regex)
 - Count models
 
 **Eloquent (Laravel):**
+
 - Glob `app/Models/**/*.php`
 - Count model files
 
 **Doctrine (Symfony/PHP):**
+
 - Glob `src/Entity/**/*.php`
 - Count entity files
 
 **Hibernate/JPA (Java):**
+
 - Glob `**/*Entity.java`
 - Count entity files
 
 **Entity Framework (.NET):**
+
 - Glob `**/Models/**/*.cs` or `**/Entities/**/*.cs`
 - Count entity files
 
 **GORM (Go):**
+
 - Search for `type.*struct` in `models/**/*.go`
 - Count structs
 
 **ActiveRecord (Ruby):**
+
 - Glob `app/models/**/*.rb`
 - Count model files
 
@@ -639,6 +650,7 @@ Checking docs/ directory...
 ```
 
 **Maturity Level:**
+
 - 🌱 **Minimal:** 0-1 docs → Suggest **MVP or Production-Ready scope**
 - 🌿 **Basic:** 2-4 docs → Suggest **Production-Ready scope**
 - 🌳 **Comprehensive:** 5-7 docs → Suggest **Production-Ready or Enterprise scope**
@@ -652,7 +664,7 @@ Checking docs/ directory...
 🏛️  Architecture Pattern: [Feature-based/Layer-based/Modular/Hybrid]
 
 📊 Code Structure:
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
 [Language-specific breakdown, e.g., for Node.js:]
 
   Controllers: [X files]
@@ -670,8 +682,7 @@ Checking docs/ directory...
   Tests: [X files] → Coverage estimate: [Low/Medium/High]
 
 [etc., adapt to detected language]
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+---
 📂 Organization:
 [Example for Feature-based:]
   ✓ src/users/ (3 controllers, 5 services, 2 entities)
@@ -691,9 +702,7 @@ Checking docs/ directory...
 
 💾 Context Used: ~3,500 tokens (total: ~4,700)
 ⏱️  Time Elapsed: 1m 15s
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+---
 💡 Recommended Scope: [MVP / Production-Ready / Enterprise]
    (Based on detected maturity level and code complexity)
 
@@ -707,9 +716,7 @@ Your choice: __
 ```
 
 **Context Usage:** ~2,000-5,000 tokens (cumulative: ~3,000-6,500)
-
----
-
+---
 ## 0.3 Layer 3: Selective Deep Analysis (1-5 minutes, OPTIONAL)
 
 ```
@@ -753,8 +760,7 @@ Select areas (use arrow keys, space to select, enter to confirm):
     ⏱️  Estimated time: 90-120 seconds
     💾 Context cost: ~8,000-15,000 tokens
     ⚠️  HIGH CONTEXT USAGE
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
 Total estimated: ~2-3 minutes, ~9,000-18,000 tokens
 
 Or:
@@ -781,11 +787,11 @@ function selectFilesToAnalyze(files: string[], category: string, maxFiles: numbe
     services: 9,
     entities: 10,
     repositories: 8,
-    dto: 7
+    dto: 7,
   };
 
   // Group by module/feature
-  const byModule = groupBy(files, file => file.split('/')[1]);
+  const byModule = groupBy(files, (file) => file.split('/')[1]);
 
   // Sample proportionally from each module
   const samples = [];
@@ -851,6 +857,7 @@ Your choice: __
 **Node.js/TypeScript:**
 
 **API Endpoints (NestJS):**
+
 ```typescript
 // Sample up to 30 controller files
 const controllerFiles = glob('**/*.controller.{ts,js}').slice(0, 30);
@@ -867,7 +874,7 @@ for (const file of controllerFiles) {
     ...content.matchAll(/@Post\(['"](.+?)['"]\)\s+(\w+)/g),
     ...content.matchAll(/@Put\(['"](.+?)['"]\)\s+(\w+)/g),
     ...content.matchAll(/@Delete\(['"](.+?)['"]\)\s+(\w+)/g),
-    ...content.matchAll(/@Patch\(['"](.+?)['"]\)\s+(\w+)/g)
+    ...content.matchAll(/@Patch\(['"](.+?)['"]\)\s+(\w+)/g),
   ];
 
   for (const [fullMatch, path, handlerName, method] of routes) {
@@ -875,13 +882,14 @@ for (const file of controllerFiles) {
       method: method,
       path: `${basePath}/${path}`,
       handler: handlerName,
-      file: file
+      file: file,
     });
   }
 }
 ```
 
 **API Endpoints (Express):**
+
 ```typescript
 const routeFiles = glob('**/routes/**/*.{ts,js}').slice(0, 20);
 
@@ -890,16 +898,17 @@ for (const file of routeFiles) {
 
   const routes = [
     ...content.matchAll(/router\.(get|post|put|delete|patch)\(['"](.+?)['"],\s*(\w+)/g),
-    ...content.matchAll(/app\.(get|post|put|delete|patch)\(['"](.+?)['"],\s*(\w+)/g)
+    ...content.matchAll(/app\.(get|post|put|delete|patch)\(['"](.+?)['"],\s*(\w+)/g),
   ];
 
   for (const [, method, path, handler] of routes) {
-    endpoints.push({method: method.toUpperCase(), path, handler, file});
+    endpoints.push({ method: method.toUpperCase(), path, handler, file });
   }
 }
 ```
 
 **Entities (Prisma):**
+
 ```typescript
 // Read prisma/schema.prisma
 const schema = readFile('prisma/schema.prisma');
@@ -915,9 +924,9 @@ for (const [, modelName, body] of models) {
     fields: fields.map(([, name, type, decorator]) => ({
       name,
       type,
-      decorator
+      decorator,
     })),
-    relationships: [...body.matchAll(/@relation\(([^)]+)\)/g)].map(m => m[1])
+    relationships: [...body.matchAll(/@relation\(([^)]+)\)/g)].map((m) => m[1]),
   };
 
   entities.push(entity);
@@ -927,6 +936,7 @@ for (const [, modelName, body] of models) {
 **Python:**
 
 **API Endpoints (FastAPI):**
+
 ```python
 # Sample router files
 routerFiles = glob('**/*routes.py', '**/*router.py')[:20]
@@ -947,6 +957,7 @@ for file in routerFiles:
 ```
 
 **Entities (Django):**
+
 ```python
 # Read models.py files
 modelFiles = glob('**/models.py')[:15]
@@ -970,6 +981,7 @@ for file in modelFiles:
 **PHP:**
 
 **API Endpoints (Laravel):**
+
 ```php
 // Read routes/api.php and routes/web.php
 $routeFiles = ['routes/api.php', 'routes/web.php'];
@@ -992,6 +1004,7 @@ foreach ($routeFiles as $file) {
 ```
 
 **Entities (Eloquent):**
+
 ```php
 // Glob app/Models/*.php
 $modelFiles = glob('app/Models/*.php');
@@ -1014,6 +1027,7 @@ foreach ($modelFiles as $file) {
 **Java:**
 
 **API Endpoints (Spring Boot):**
+
 ```java
 // Glob **/*Controller.java (sample 25)
 List<String> controllerFiles = glob("**/*Controller.java").subList(0, 25);
@@ -1040,6 +1054,7 @@ for (String file : controllerFiles) {
 ```
 
 **Entities (JPA/Hibernate):**
+
 ```java
 // Glob **/*Entity.java
 List<String> entityFiles = glob("**/*Entity.java").subList(0, 30);
@@ -1069,6 +1084,7 @@ for (String file : entityFiles) {
 **C#/.NET:**
 
 **API Endpoints (ASP.NET Core):**
+
 ```csharp
 // Glob **/*Controller.cs
 var controllerFiles = Directory.GetFiles(".", "*Controller.cs", SearchOption.AllDirectories).Take(25);
@@ -1095,6 +1111,7 @@ foreach (var file in controllerFiles) {
 ```
 
 **Entities (Entity Framework):**
+
 ```csharp
 // Glob **/Models/**/*.cs or **/Entities/**/*.cs
 var entityFiles = Directory.GetFiles(".", "*.cs", SearchOption.AllDirectories)
@@ -1125,6 +1142,7 @@ foreach (var file in entityFiles) {
 **Go:**
 
 **API Endpoints (Gin):**
+
 ```go
 // Read handler files
 handlerFiles := filepath.Glob("**/handlers/**/*.go")[:20]
@@ -1148,6 +1166,7 @@ for _, file := range handlerFiles {
 ```
 
 **Entities (GORM):**
+
 ```go
 // Read model files
 modelFiles := filepath.Glob("**/models/**/*.go")[:20]
@@ -1180,6 +1199,7 @@ for _, file := range modelFiles {
 **Ruby:**
 
 **API Endpoints (Rails):**
+
 ```ruby
 # Read routes.rb
 routes_file = 'config/routes.rb'
@@ -1214,6 +1234,7 @@ end
 ```
 
 **Entities (ActiveRecord):**
+
 ```ruby
 # Glob app/models/*.rb
 model_files = Dir.glob('app/models/**/*.rb')[0..20]
@@ -1242,6 +1263,7 @@ end
 **Rust:**
 
 **API Endpoints (Actix):**
+
 ```rust
 // Read handler files
 let handler_files: Vec<_> = glob("**/handlers/**/*.rs").unwrap().take(15).collect();
@@ -1264,6 +1286,7 @@ for file in handler_files {
 ```
 
 **Entities (Diesel):**
+
 ```rust
 // Read schema.rs and models.rs
 let schema = fs::read_to_string("src/schema.rs").ok();
@@ -1287,12 +1310,14 @@ if let Some(schema_content) = schema {
 **Scan for security patterns across all languages:**
 
 **Authentication:**
+
 - JWT libraries: `jsonwebtoken`, `@nestjs/jwt`, `pyjwt`, `jjwt`, etc.
 - Session libraries: `express-session`, `django.contrib.sessions`
 - OAuth libraries: `passport`, `authlib`, `spring-security-oauth2`
 - Password hashing: `bcrypt`, `argon2`, `password_hash` (PHP)
 
 **Validation:**
+
 - `class-validator`, `joi`, `zod` (Node.js)
 - `pydantic`, `marshmallow` (Python)
 - Laravel validation rules (PHP)
@@ -1300,16 +1325,19 @@ if let Some(schema_content) = schema {
 - Data Annotations (.NET)
 
 **Rate Limiting:**
+
 - `express-rate-limit`, `@nestjs/throttler`
 - `django-ratelimit`, `slowapi`
 - Bucket4j (Java)
 
 **CORS:**
+
 - `cors` package (Node.js)
 - `django-cors-headers` (Python)
 - Spring CORS configuration (Java)
 
 **Security Headers:**
+
 - `helmet` (Node.js)
 - `django-csp`
 - OWASP Java Encoder
@@ -1363,8 +1391,7 @@ Security Headers:
   ℹ️  Remaining checks deferred
   ⏱️  Elapsed: 20s
   💾 Tokens: 1,800
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
 Total: 2m 20s | 14,500 tokens used
 Remaining context: 155,500 tokens
 ```
@@ -1375,7 +1402,7 @@ Remaining context: 155,500 tokens
 ✅ Layer 3 Complete (2m 30s)
 
 📡 API Endpoints: [127 detected]
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
 By Method:
   GET: 58 endpoints
   POST: 32 endpoints
@@ -1395,10 +1422,10 @@ Sample Endpoints:
   • GET /api/users/:id → UsersController.findOne
   • POST /api/products → ProductsController.create
   • PUT /api/orders/:id → OrdersController.update
-  [View full list in analysis.json]
+  [View full list in docs-analysis.json]
 
 🗄️  Database Entities: [18 detected]
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
 Core Entities:
   • User (8 fields, 3 relationships)
     - Relationships: OneToMany → Orders, OneToMany → Reviews
@@ -1407,10 +1434,10 @@ Core Entities:
   • Order (10 fields, 4 relationships)
     - Relationships: ManyToOne → User, OneToMany → OrderItems, etc.
 
-  [+15 more entities - see analysis.json for full schema]
+  [+15 more entities - see docs-analysis.json for full schema]
 
 🔒 Security Patterns:
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
   ✅ Authentication: JWT with bcrypt
   ✅ Validation: class-validator + DTOs
   ⚠️  Rate Limiting: Not detected
@@ -1419,14 +1446,11 @@ Core Entities:
 
 💾 Context Used: ~14,500 tokens (total: ~18,700)
 ⏱️  Time Elapsed: 3m 45s
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
 ```
 
 **Context Usage:** ~5,000-25,000 tokens (cumulative: ~8,000-31,500)
-
----
-
+---
 ## 0.4 Proactive Improvement Suggestions
 
 ```
@@ -1474,9 +1498,7 @@ Based on my analysis, I found opportunities for improvement:
    Action: Implement cursor-based or offset pagination
    Impact: Better performance with large datasets
    Estimated effort: 2-3 hours
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+---
 Would you like to:
 
 A) ✅ Address these during build (I'll integrate into relevant phases)
@@ -1492,23 +1514,24 @@ Your choice: __
 ```
 
 **If user selects A:**
+
 - Mark suggestions to be addressed in relevant phases
 - When reaching those phases, reference: "Earlier analysis detected X, let's configure it now"
 
 **If user selects B:**
+
 - Create `suggestions.md` with all recommendations formatted for reference
 
 **If user selects C:**
-- Continue without suggestions
-
----
 
+- Continue without suggestions
+---
 ## 0.5 Export Analysis Results
 
 ```
 💾 Export Analysis to JSON?
 
-This creates .ai-flow/analysis.json with all detected information:
+This creates .ai-flow/cache/docs-analysis.json with all detected information:
 • Project metadata and tech stack
 • Complete endpoint list with methods, paths, handlers
 • Full entity schemas with relationships
@@ -1592,13 +1615,13 @@ Your choice: __
       "source": "prisma",
       "file": "prisma/schema.prisma",
       "fields": [
-        {"name": "id", "type": "String", "required": true, "primary": true},
-        {"name": "email", "type": "String", "required": true, "unique": true},
-        {"name": "password", "type": "String", "required": true}
+        { "name": "id", "type": "String", "required": true, "primary": true },
+        { "name": "email", "type": "String", "required": true, "unique": true },
+        { "name": "password", "type": "String", "required": true }
       ],
       "relationships": [
-        {"type": "OneToMany", "target": "Order", "field": "orders"},
-        {"type": "OneToMany", "target": "Review", "field": "reviews"}
+        { "type": "OneToMany", "target": "Order", "field": "orders" },
+        { "type": "OneToMany", "target": "Review", "field": "reviews" }
       ]
     }
     // ... 17 more
@@ -1638,7 +1661,7 @@ Your choice: __
     "count": 87,
     "paths": [
       "src/users/users.controller.ts",
-      "src/products/products.controller.ts",
+      "src/products/products.controller.ts"
       // ... all analyzed files
     ],
     "timestamps": {
@@ -1651,7 +1674,7 @@ Your choice: __
 ```
 
 ```
-✅ Analysis exported to .ai-flow/analysis.json
+✅ Analysis exported to .ai-flow/cache/docs-analysis.json
 
 File size: 142 KB
 Contains:
@@ -1662,9 +1685,7 @@ Contains:
 
 You can view/edit this file anytime or share with your team.
 ```
-
----
-
+---
 ## 0.6 Load Detected Context & Pre-populate Answers
 
 **If user selected "Use detected information":**
@@ -1725,9 +1746,7 @@ Phase 7 (Operations):
   ❓ Environment setup: [NEED TO ASK]
   ❓ Monitoring: [NEED TO ASK]
   ❓ Logging: [NEED TO ASK]
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+---
 📊 Analysis Summary:
   • Pre-populated: ~45% of answers
   • Need to ask: ~55% (gaps in documentation)
@@ -1737,9 +1756,7 @@ Ready to proceed to Project Scope Selection?
 
 Type 'yes' to continue: __
 ```
-
----
-
+---
 ## 0.7 Error Handling & Recovery
 
 **If any layer fails:**
@@ -1793,16 +1810,13 @@ Progress: 24 of 30 files analyzed (80% success rate)
 3. **Out of memory:** Reduce sample size, retry
 4. **Context limit:** Stop analysis, use partial results
 5. **Network timeout:** (if remote files) Retry with backoff
-
----
-
+---
 ## 🎯 Summary: Phase 0 Complete
 
 ```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
 ✅ CONTEXT DISCOVERY COMPLETE
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+---
 📊 Project: ecommerce-api
 🛠️  Stack: TypeScript 5.3 + NestJS 10.2 + Prisma 5.7 + PostgreSQL
 📈 Maturity: Basic documentation
@@ -1813,7 +1827,7 @@ Analysis Results:
   ✅ 18 database entities with 45 relationships
   ✅ Security patterns analyzed
   ✅ 7 improvement suggestions generated
-  ✅ Analysis exported to .ai-flow/analysis.json
+  ✅ Analysis exported to .ai-flow/cache/docs-analysis.json
 
 Pre-population Status:
   • 45% of questionnaire answers populated
@@ -1826,17 +1840,15 @@ Performance:
   📊 Remaining: 181,300 tokens for phases 1-7
 
 Next Step: Project Scope Selection
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+---
 Press Enter to continue to Project Scope Selection...
 ```
-
----
-
+---
 **After Phase 0 completes, ALWAYS proceed to Project Scope Selection before Phase 1.**
-
----
+---
 ## PHASE 1: Discovery & Business (15-20 min)
 
 
 
+
+