ai-flow-dev 2.1.1 → 2.1.3

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

@@ -48,46 +48,46 @@ Do you need to add more entities? (Y/N)
 Based on your system type (from Phase 1, question 1.5), here are common entities:
 
 🛒 E-commerce typical entities:
-A) User - System users with authentication
-B) Product - Items available for purchase
-C) Category - Product categorization
-D) Cart - Shopping cart items
-E) Order - Customer orders
-F) OrderItem - Individual items in an order
-G) Payment - Payment transactions
-H) Address - Shipping/billing addresses
-I) Review - Product reviews and ratings
-J) Inventory - Stock tracking
+1) User - System users with authentication
+2) Product - Items available for purchase
+3) Category - Product categorization
+4) Cart - Shopping cart items
+5) Order - Customer orders
+6) OrderItem - Individual items in an order
+7) Payment - Payment transactions
+8) Address - Shipping/billing addresses
+9) Review - Product reviews and ratings
+10) Inventory - Stock tracking
 
 📱 SaaS typical entities:
-A) User - System users
-B) Organization - Tenant/workspace
-C) Team - Groups within organizations
-D) Role - Access control roles
-E) Permission - Granular permissions
-F) Subscription - Billing plans
-G) Invoice - Payment records
-H) ApiKey - API access credentials
-I) AuditLog - Activity tracking
+1) User - System users
+2) Organization - Tenant/workspace
+3) Team - Groups within organizations
+4) Role - Access control roles
+5) Permission - Granular permissions
+6) Subscription - Billing plans
+7) Invoice - Payment records
+8) ApiKey - API access credentials
+9) AuditLog - Activity tracking
 
 📊 CRM typical entities:
-A) User - System users
-B) Contact - Customers/leads
-C) Company - Organizations
-D) Deal - Sales opportunities
-E) Activity - Calls, emails, meetings
-F) Task - To-do items
-G) Note - Free-form notes
-H) Document - Attachments
+1) User - System users
+2) Contact - Customers/leads
+3) Company - Organizations
+4) Deal - Sales opportunities
+5) Activity - Calls, emails, meetings
+6) Task - To-do items
+7) Note - Free-form notes
+8) Document - Attachments
 
 🎮 Social typical entities:
-A) User - Platform users
-B) Profile - User profiles
-C) Post - Content/publications
-D) Comment - Post comments
-E) Like/Reaction - Engagement
-F) Follow - User connections
-G) Notification - User alerts
+1) User - Platform users
+2) Profile - User profiles
+3) Post - Content/publications
+4) Comment - Post comments
+5) Like/Reaction - Engagement
+6) Follow - User connections
+7) Notification - User alerts
 H) Message - Direct messages
 I) Group - Communities
 
@@ -350,14 +350,13 @@ Is this correct? (Yes/No)
 ✅ Re-reading project-brief.md
 ```
 
-Once confirmed, generate:
-
-**1. `docs/data-model.md`**
+**Generate `docs/data-model.md` automatically:**
 
 - Use template: `.ai-flow/templates/docs/data-model.template.md`
 - Fill with all Phase 2 entity and relationship information
 - Include entity catalog, relationships, data patterns
 - Generate entity-relationship diagram (ER diagram) in mermaid format showing all entities and their relationships
+- Write to: `docs/data-model.md`
 
 ---
 
@@ -434,8 +433,8 @@ erDiagram
 
 **Common Mistakes to Avoid:**
 
-- ❌ ` ​```Mermaid ` (capital M - will not render)
-- ❌ ` ​``` mermaid ` (extra space - will not render)
+- ❌ `​```Mermaid` (capital M - will not render)
+- ❌ `​``` mermaid` (extra space - will not render)
 - ❌ Indenting the entire diagram with spaces/tabs
 - ❌ Missing closing ` ``` ` fence
 - ❌ Invalid entity/relationship syntax
@@ -447,25 +446,24 @@ erDiagram
 ```
 ✅ Generated: docs/data-model.md
 
-📝 Please review this document. Do you need to make any corrections?
+Document has been created with all Phase 2 information.
+
+📝 Would you like to make any corrections before continuing?
 
-A) ✅ Looks perfect, continue to Phase 3
-B) 📝 I'll edit it now (I'll wait)
-C) 🔄 Regenerate with changes (tell me what to modify)
+→ If yes: Edit docs/data-model.md and type "ready" when done. I'll re-read it.
+→ If no: Type "continue" to proceed to Phase 3.
 ```
 
-**If user selects B:**
+**If user edits the file:**
+Execute `read_file('docs/data-model.md')` to refresh context before continuing.
 
-```
-Perfect. Please edit docs/data-model.md and type "ready" when you're done.
-I'll re-read the file to update my context before continuing.
-```
+---
 
-Then execute: `read_file('docs/data-model.md')` to refresh context.
+> ⚠️ **CRITICAL:** DO NOT generate README.md in Phase 2. README.md is ONLY generated in Phase 8 (step 8.5) after framework initialization.
 
 ---
 
-**Proceed to Phase 3 only after document is validated.**
+**Proceed to Phase 3 after document is generated and optionally reviewed.**
 
 ---
 

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

@@ -661,45 +661,44 @@ Is this correct? (Yes/No)
 ✅ Re-reading docs/data-model.md
 ```
 
-Once confirmed, generate:
+**Generate documents automatically:**
 
 **1. `docs/architecture.md`**
 
 - Use template: `.ai-flow/templates/docs/architecture.template.md`
 - Fill with system architecture, patterns, tech stack
 - Include architecture diagram (mermaid format)
+- Write to: `docs/architecture.md`
 
 **2. `ai-instructions.md`**
 
 - Use template: `.ai-flow/templates/ai-instructions.template.md`
 - Fill with tech stack, framework, language, key dependencies
 - Include NEVER/ALWAYS rules specific to chosen stack
-- Generate idiomatic code examples for Controller, Service, Repository, DTO and Module placeholders, strictly following the selected Architecture Pattern (e.g., if Hexagonal, show Ports & Adapters).
+- Generate idiomatic code examples for Controller, Service, Repository, DTO and Module placeholders, strictly following the selected Architecture Pattern (e.g., if Hexagonal, show Ports & Adapters)
+- Write to: `ai-instructions.md`
 
 ```
 ✅ Generated: docs/architecture.md
 ✅ Generated: ai-instructions.md
 
-📝 Please review these documents. Do you need to make any corrections?
+Documents have been created with all Phase 3 information.
 
-A) ✅ Look perfect, continue to Phase 4
-B) 📝 I'll edit them now (I'll wait)
-C) 🔄 Regenerate with changes (tell me what to modify)
-```
-
-**If user selects B:**
+📝 Would you like to make any corrections before continuing?
 
-```
-Perfect. Please edit the documents and type "ready" when you're done.
-I'll re-read all files to update my context before continuing.
+→ If yes: Edit the files and type "ready" when done. I'll re-read them.
+→ If no: Type "continue" to proceed to Phase 4.
 ```
 
-Then execute: `read_file()` for both documents to refresh context.
+**If user edits files:**
+Execute `read_file()` for both documents to refresh context before continuing.
 
 ---
 
 **Proceed to Phase 4 only after documents are validated.**
 
+> ⚠️ **CRITICAL:** DO NOT generate README.md in this phase. README.md is ONLY generated in Phase 8 (step 8.5) after framework initialization.
+
 ---
 
 ## PHASE 4: Security & Authentication (15-20 min)

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

@@ -476,12 +476,13 @@ Is this correct? (Yes/No)
 ✅ Re-reading ai-instructions.md
 ```
 
-Once confirmed, generate:
+**Generate documents automatically:**
 
 **1. `specs/security.md`**
 
 - Use template: `.ai-flow/templates/specs/security.template.md`
 - Fill with all security policies, authentication, authorization
+- Write to: `specs/security.md`
 
 **2. Update `ai-instructions.md`**
 
@@ -492,25 +493,23 @@ Once confirmed, generate:
 ✅ Generated: specs/security.md
 ✅ Updated: ai-instructions.md (security rules added)
 
-📝 Please review these documents. Do you need to make any corrections?
+Documents have been created with all Phase 4 information.
 
-A) ✅ Look perfect, continue to Phase 5
-B) 📝 I'll edit them now (I'll wait)
-C) 🔄 Regenerate with changes (tell me what to modify)
-```
-
-**If user selects B:**
+📝 Would you like to make any corrections before continuing?
 
-```
-Perfect. Please edit the documents and type "ready" when you're done.
-I'll re-read all files to update my context before continuing.
+→ If yes: Edit the files and type "ready" when done. I'll re-read them.
+→ If no: Type "continue" to proceed to Phase 5.
 ```
 
+**If user edits files:**
+Re-read files to refresh context before continuing.
+
 ---
 
 **Proceed to Phase 5 only after documents are validated.**
 
----
+> ⚠️ **CRITICAL:** DO NOT generate README.md in this phase. README.md is ONLY generated in Phase 8 (step 8.5) after framework initialization.
 
-## PHASE 5: Code Standards (15-20 min)
+---
 
+## PHASE 5: Development Standards (15-20 min)

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

@@ -599,12 +599,13 @@ Is this correct? (Yes/No)
 ✅ Re-reading specs/security.md
 ```
 
-Once confirmed, generate:
+**Generate documents automatically:**
 
 **1. `docs/code-standards.md`**
 
 - Use template: `.ai-flow/templates/docs/code-standards.template.md`
 - Fill with all code quality rules, naming conventions, formatting
+- Write to: `docs/code-standards.md`
 
 **2. Update `ai-instructions.md`**
 
@@ -615,24 +616,23 @@ Once confirmed, generate:
 ✅ Generated: docs/code-standards.md
 ✅ Updated: ai-instructions.md (code standards added)
 
-📝 Please review these documents. Do you need to make any corrections?
+Documents have been created with all Phase 5 information.
 
-A) ✅ Look perfect, continue to Phase 6
-B) 📝 I'll edit them now (I'll wait)
-C) 🔄 Regenerate with changes (tell me what to modify)
-```
-
-**If user selects B:**
+📝 Would you like to make any corrections before continuing?
 
-```
-Perfect. Please edit the documents and type "ready" when you're done.
-I'll re-read all files to update my context before continuing.
+→ If yes: Edit the files and type "ready" when done. I'll re-read them.
+→ If no: Type "continue" to proceed to Phase 6.
 ```
 
+**If user edits files:**
+Re-read files to refresh context before continuing.
+
 ---
 
 **Proceed to Phase 6 only after documents are validated.**
 
+> ⚠️ **CRITICAL:** DO NOT generate README.md in this phase. README.md is ONLY generated in Phase 8 (step 8.5) after framework initialization.
+
 ---
 
-## PHASE 6: Testing Strategy (15-25 min)
+## PHASE 6: Testing Strategy (10 min)

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

@@ -430,35 +430,33 @@ Is this correct? (Yes/No)
 ✅ Re-reading ai-instructions.md
 ```
 
-Once confirmed, generate:
-
-**1. `docs/testing.md`**
+**Generate `docs/testing.md` automatically:**
 
 - Use template: `.ai-flow/templates/docs/testing.template.md`
 - **If MVP scope:** Fill with basic testing strategy: framework selection, smoke tests on critical paths, coverage 15-25%, basic CI setup. Mark advanced sections as "Not implemented yet - expand when moving to Production-Ready"
 - **If Production-Ready:** Fill with comprehensive testing strategy: framework, unit/integration/e2e tests, 60-80% coverage, test data management, mocking, full CI/CD
 - **If Enterprise:** Fill with exhaustive testing strategy: all Production-Ready items + contract tests, load tests, security tests, 80-95% coverage, performance benchmarks
+- Write to: `docs/testing.md`
 
 ```
 ✅ Generated: docs/testing.md
 
-📝 Please review this document. Do you need to make any corrections?
-
-A) ✅ Looks perfect, continue to Phase 7
-B) 📝 I'll edit it now (I'll wait)
-C) 🔄 Regenerate with changes (tell me what to modify)
-```
+Document has been created with all Phase 6 information.
 
-**If user selects B:**
+📝 Would you like to make any corrections before continuing?
 
+→ If yes: Edit the file and type "ready" when done. I'll re-read it.
+→ If no: Type "continue" to proceed to Phase 7.
 ```
-Perfect. Please edit the document and type "ready" when you're done.
-I'll re-read all files to update my context before continuing.
-```
+
+**If user edits file:**
+Re-read file to refresh context before continuing.
 
 ---
 
-**Proceed to Phase 7 only after document is validated.**
+**Proceed to Phase 7 only after documents are validated.**
+
+> ⚠️ **CRITICAL:** DO NOT generate README.md in this phase. README.md is ONLY generated in Phase 8 (step 8.5) after framework initialization.
 
 ---
 

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

@@ -815,41 +815,41 @@ Is this correct? (Yes/No)
 ✅ Re-reading ai-instructions.md
 ```
 
-Once confirmed, generate:
+**Generate documents automatically:**
 
 **1. `docs/operations.md`**
 
 - Use template: `.ai-flow/templates/docs/operations.template.md`
 - Fill with deployment, monitoring, alerting, backup, scaling
+- Write to: `docs/operations.md`
 
 **2. `specs/configuration.md`**
 
 - Use template: `.ai-flow/templates/specs/configuration.template.md`
 - Fill with environment variables, secrets management, feature flags
+- Write to: `specs/configuration.md`
 
 **3. `.env.example`**
 
 - List all environment variables needed
 - Include comments explaining each variable
+- Write to: `.env.example`
 
 ```
 ✅ Generated: docs/operations.md
 ✅ Generated: specs/configuration.md
 ✅ Generated: .env.example
 
-📝 Please review these documents. Do you need to make any corrections?
+Documents have been created with all Phase 7 information.
 
-A) ✅ Look perfect, continue to final checkpoint
-B) 📝 I'll edit them now (I'll wait)
-C) 🔄 Regenerate with changes (tell me what to modify)
-```
-
-**If user selects B:**
+📝 Would you like to make any corrections before continuing?
 
+→ If yes: Edit the files and type "ready" when done. I'll re-read them.
+→ If no: Type "continue" to proceed to final checkpoint.
 ```
-Perfect. Please edit the documents and type "ready" when you're done.
-I'll re-read all files to update my context before continuing.
-```
+
+**If user edits files:**
+Re-read files to refresh context before continuing.
 
 ---
 
@@ -985,6 +985,8 @@ Phase 8 will:
 - 📄 Generate README.md (with intelligent merge if needed)
 - 🤖 Create tool-specific configs (based on AI selection)
 
+> ⚠️ **CRITICAL:** README.md MUST NOT exist yet. It will be generated in Phase 8 step 8.5 AFTER framework initialization to avoid conflicts.
+
 Continue to Phase 8? (yes/no)
 ```
 
@@ -1040,7 +1042,7 @@ When executing this master prompt:
   - [ ] Present suggestions with actions and impacts
 - [ ] **Offer export option (0.3):**
   - [ ] Ask if user wants to export analysis to JSON
-  - [ ] If yes, create .ai-flow/analysis.json with complete analysis
+  - [ ] If yes, create .ai-flow/cache/docs-analysis.json with complete analysis
 - [ ] Let user choose: A) Use detected info, B) Start fresh, C) Review/edit detected info
 - [ ] **Handle suggestions:**
   - [ ] If user selected A (address during build), integrate suggestions into relevant phases
@@ -1137,6 +1139,3 @@ This is an investment that will save 10-20 hours over the project lifecycle.
 ```
 
 ```
-
-
-

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

@@ -23,6 +23,8 @@ This final phase will:
 
 ## 8.1: Project State Detection
 
+> ⚠️ **PRE-REQUISITE CHECK:** Before proceeding, verify that README.md does NOT exist yet (unless it's a framework-generated one from previous initialization). If README.md exists and was NOT generated by a framework, this indicates an error in previous phases.
+
 ```
 🔍 Detecting current project state...
 ```
@@ -307,7 +309,7 @@ SMTP_PASS=""
 
 ```yaml
 # Copy from templates/docker-compose/postgres.template.yml
-version: "3.8"
+version: '3.8'
 
 services:
   postgres:
@@ -318,11 +320,11 @@ services:
       POSTGRES_USER: ${DB_USER:-postgres}
       POSTGRES_PASSWORD: ${DB_PASSWORD:-password}
     ports:
-      - "${DB_PORT:-5432}:5432"
+      - '${DB_PORT:-5432}:5432'
     volumes:
       - postgres_data:/var/lib/postgresql/data
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      test: ['CMD-SHELL', 'pg_isready -U postgres']
       interval: 10s
       timeout: 5s
       retries: 5
@@ -335,7 +337,7 @@ volumes:
 
 ```yaml
 # Copy from templates/docker-compose/mysql.template.yml
-version: "3.8"
+version: '3.8'
 
 services:
   mysql:
@@ -345,7 +347,7 @@ services:
       MYSQL_DATABASE: ${DB_NAME:-myapp_dev}
       MYSQL_ROOT_PASSWORD: ${DB_PASSWORD:-password}
     ports:
-      - "${DB_PORT:-3306}:3306"
+      - '${DB_PORT:-3306}:3306'
     volumes:
       - mysql_data:/var/lib/mysql
 
@@ -357,7 +359,7 @@ volumes:
 
 ```yaml
 # Copy from templates/docker-compose/mongodb.template.yml
-version: "3.8"
+version: '3.8'
 
 services:
   mongodb:
@@ -368,7 +370,7 @@ services:
       MONGO_INITDB_ROOT_USERNAME: ${DB_USER:-root}
       MONGO_INITDB_ROOT_PASSWORD: ${DB_PASSWORD:-password}
     ports:
-      - "${DB_PORT:-27017}:27017"
+      - '${DB_PORT:-27017}:27017'
     volumes:
       - mongodb_data:/data/db
 
@@ -437,9 +439,44 @@ npx prisma init
   - MySQL: https://hub.docker.com/_/mysql
   - MongoDB: https://hub.docker.com/_/mongo
 
-### 8.2.6.5: Generate .gitignore
+### 8.2.6.5: 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. Generate .gitignore (step 8.2.7 - runs for all projects)
+2. Copy .env.example to .env and configure
+3. Start database: docker-compose up -d (if applicable)
+4. Run migrations: npm run db:migrate or equivalent
+5. Start dev server: npm run start:dev or equivalent
+6. 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, .gitignore, docker-compose (optional), ORM init
+- ✅ **LET** framework CLI handle structure, configs, dependencies
+- ✅ **REFER** to official docs for starter code when needed
+
+---
+
+## 8.2.7: Generate .gitignore (Always)
 
-**IMPORTANT:** Generate a comprehensive `.gitignore` file based on the framework, language, and tools selected in previous phases.
+**IMPORTANT:** This step runs for ALL projects, regardless of framework initialization choice.
 
 ```
 📝 Generating .gitignore for your tech stack...
@@ -593,41 +630,6 @@ docker-compose.override.yml
 
 ---
 
-### 8.2.6.6: Final Summary
-
-```
-✅ Minimal enhancements complete!
-
-Files created (3-4 max):
-✅ .env.example (environment template)
-✅ .gitignore (ignore patterns for your stack)
-✅ docker-compose.yml (if Docker selected)
-✅ prisma/schema.prisma (if Prisma ORM)
-
-🎯 Total: 3-4 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, .gitignore, 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
 
 ```
@@ -1246,6 +1248,7 @@ When executing Phase 8:
   - [ ] Restore .ai-flow/ docs from temp-backup/
   - [ ] Handle README.md conflict if framework created one
 - [ ] If no: Show manual command and continue
+- [ ] Generate .gitignore (ALWAYS - step 8.2.7, runs for all projects)
 
 **8.3 Generate Final Documentation:**
 
@@ -1253,7 +1256,6 @@ When executing Phase 8:
 - [ ] Generate docs/business-flows.md (from Phase 1)
 - [ ] Generate docs/api.md (from Phase 2 + Phase 3)
 - [ ] Generate docs/contributing.md (from Phase 5 + Phase 7)
-- [ ] Generate .gitignore (based on framework and tools)
 
 **8.4 Generate AGENT.md:**
 
@@ -1382,4 +1384,3 @@ Happy coding! 🚀
 
 **SUCCESS:** Project fully documented and ready for development! 🚀
 ```
-