ai-flow-dev 1.4.0 → 2.0.1

package/prompts/backend/{flow-bootstrap-phase-3.md → flow-build-phase-3.md}

@@ -514,80 +514,102 @@ Will you integrate with external services?
 Select all that apply:
 
 💳 Payment Providers:
-□ Stripe - Credit cards, subscriptions ⭐
-□ PayPal - Popular payment method
-□ Square - POS and online payments
-□ Mercado Pago - Latin America
-□ Other: __
+A) Stripe - Credit cards, subscriptions ⭐
+B) PayPal - Popular payment method
+C) Square - POS and online payments
+D) Mercado Pago - Latin America
+E) Other: __
+
+→ Your selection (e.g., A): __
 
 📧 Email Services:
-□ AWS SES - Cost-effective, scalable ⭐
-□ SendGrid - Feature-rich, analytics
-□ Mailgun - Developer-friendly
-□ Postmark - Transactional focus
-□ Resend - Modern, simple API ⚡
-□ Other: __
+A) AWS SES - Cost-effective, scalable ⭐
+B) SendGrid - Feature-rich, analytics
+C) Mailgun - Developer-friendly
+D) Postmark - Transactional focus
+E) Resend - Modern, simple API ⚡
+F) Other: __
+
+→ Your selection (e.g., A, B): __
 
 📱 SMS/Messaging:
-□ Twilio - SMS, WhatsApp, voice ⭐
-□ AWS SNS - Simple notifications
-□ MessageBird - Multi-channel
-□ Other: __
+C) MessageBird - Multi-channel
+D) Other: __
+
+→ Your selection (e.g., A): __
 
 ☁️ Cloud Storage:
-□ AWS S3 - Object storage standard ⭐
-□ Google Cloud Storage
-□ Azure Blob Storage
-□ Cloudflare R2 - S3-compatible, no egress fees ⚡
-□ Other: __
+
+D) Cloudflare R2 - S3-compatible, no egress fees ⚡
+E) Other: __
+
+→ Your selection (e.g., A): __
+
+📊 Analytics: Storage
+D) Cloudflare R2 - S3-compatible, no egress fees ⚡
+E) Other: __
 
 📊 Analytics:
-□ Google Analytics - Web analytics
-□ Mixpanel - Product analytics ⭐
-□ Segment - Data pipeline
-□ PostHog - Open-source analytics ⚡
-□ Amplitude - Behavioral analytics
-□ Other: __
-
-🔍 Monitoring/Error Tracking:
-□ Sentry - Error tracking ⭐
-□ Datadog - Full observability 🏆
-□ New Relic - APM
-□ LogRocket - Session replay
-□ Other: __
-
-🗺️ Maps/Location:
-□ Google Maps API
-□ Mapbox
-□ OpenStreetMap
-□ Other: __
+E) Amplitude - Behavioral analytics
+F) Other: __
+
+→ Your selection (e.g., B, C): __
+
+🔍 Monitoring/Error Tracking:ytics ⚡
+E) Amplitude - Behavioral analytics
+D) LogRocket - Session replay
+E) Other: __
+
+→ Your selection (e.g., A): __
+
+🗺️ Maps/Location:tracking ⭐
+B) Datadog - Full observability 🏆
+C) New Relic - APM
+C) OpenStreetMap
+D) Other: __
+
+→ Your selection (e.g., A): __
 
 🔐 Authentication:
-□ Auth0 - Identity platform 🏆
-□ Clerk - Modern auth ⚡
-□ Supabase Auth - Open-source
-□ Firebase Auth - Google ecosystem
-□ Other: __
+A) Google Maps API
+D) Firebase Auth - Google ecosystem
+E) Other: __
+
+→ Your selection (e.g., A, B): __
 
 🤖 AI/ML Services:
-□ OpenAI API - GPT models
-□ Anthropic Claude - AI assistant
-□ Google Gemini - Multimodal AI
-□ AWS Bedrock - Managed AI
-□ Other: __
-
-📞 Communication:
-□ Slack - Team notifications
-□ Discord - Community integration
-□ Webhooks - Custom integrations
-□ Other: __
+🔐 Authentication:
+D) AWS Bedrock - Managed AI
+E) Other: __
+
+→ Your selection (e.g., A): __
+
+📞 Communication:- Google ecosystem
+E) Other: __
+
+C) Webhooks - Custom integrations
+D) Other: __
+
+→ Your selection (e.g., A, B): __
+
+🔄 Other Integrations:timodal AI
+D) AWS Bedrock - Managed AI
+D) Accounting (QuickBooks, Xero)
+E) Other: __
+
+→ Your selection (e.g., A, B, C): __
+
+---
+
+For each selected, briefly describe the use case:
+D) Other: __
 
 🔄 Other Integrations:
-□ GitHub/GitLab API
-□ Calendar (Google/Outlook)
-□ CRM (Salesforce, HubSpot)
-□ Accounting (QuickBooks, Xero)
-□ Other: __
+A) GitHub/GitLab API
+B) Calendar (Google/Outlook)
+C) CRM (Salesforce, HubSpot)
+D) Accounting (QuickBooks, Xero)
+E) Other: __
 
 ---
 
@@ -681,4 +703,3 @@ Then execute: `read_file()` for both documents to refresh context.
 ---
 
 ## PHASE 4: Security & Authentication (15-20 min)
-

package/prompts/backend/{flow-bootstrap-phase-5.md → flow-build-phase-5.md}

@@ -543,14 +543,16 @@ Default log level:
 - Production: __
 
 Log context to include:
-□ Request ID (for tracing)
-□ User ID (if authenticated)
-□ IP address
-□ User agent
-□ Request path
-□ Response status
-□ Duration
-□ Error stack traces
+A) Request ID (for tracing)
+B) User ID (if authenticated)
+C) IP address
+D) User agent
+E) Request path
+F) Response status
+G) Duration
+H) Error stack traces
+
+→ Your selection (e.g., A, B, E, F, G): __
 
 Log aggregation tool:
 A) ⭐ CloudWatch (AWS)
@@ -634,4 +636,3 @@ I'll re-read all files to update my context before continuing.
 ---
 
 ## PHASE 6: Testing Strategy (15-25 min)
-

package/prompts/backend/{flow-bootstrap-phase-6.md → flow-build-phase-6.md}

@@ -321,12 +321,14 @@ D) Custom scripts
 E) Other: __
 
 Chaos experiments to run:
-□ Network latency injection
-□ Service failures
-□ Database connection failures
-□ CPU/memory exhaustion
-□ Disk space issues
-□ Network partition
+A) Network latency injection
+B) Service failures
+C) Database connection failures
+D) CPU/memory exhaustion
+E) Disk space issues
+F) Network partition
+
+→ Your selection (e.g., A, B, C): __
 
 Safety rules:
 - Run only in: [Staging, Production with approval]
@@ -462,4 +464,3 @@ I'll re-read all files to update my context before continuing.
 
 ## PHASE 7: Operations & Deployment (10 min)
 ````
-

package/prompts/backend/{flow-bootstrap-phase-7.md → flow-build-phase-7.md}

@@ -1043,7 +1043,7 @@ When executing this master prompt:
   - [ ] If yes, create .ai-flow/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 bootstrap), integrate suggestions into relevant phases
+  - [ ] If user selected A (address during build), integrate suggestions into relevant phases
   - [ ] If user selected B (save for later), create suggestions.md file
   - [ ] If user selected C (skip), continue without changes
 - [ ] Pre-populate answers based on detected information
@@ -1116,7 +1116,7 @@ This is an investment that will save 10-20 hours over the project lifecycle.
 
 **EXECUTION FLOW:**
 
-1. **START:** User runs `/flow-bootstrap`
+1. **START:** User runs `/flow-build`
 2. **DETECT:** Check for existing project files (Phase 0)
    - If existing files found → Run Phase 0 deep analysis:
      - 0.1: Deep Code Analysis (file structure, AST parsing, schema extraction, pattern detection)
@@ -1132,9 +1132,11 @@ This is an investment that will save 10-20 hours over the project lifecycle.
 
 ---
 
-**BEGIN EXECUTION when user runs `/flow-bootstrap`**
+**BEGIN EXECUTION when user runs `/flow-build`**
 
 ```
 
 ```
 
+
+

package/prompts/backend/{flow-bootstrap-phase-8.md → flow-build-phase-8.md}

@@ -84,7 +84,7 @@ B) ⏭️  Skip for now (manual setup later)
 📦 Preparing for framework initialization...
 
 Creating backup of AI Flow documentation:
-→ Moving .ai-flow/ docs to .ai-flow/temp-backup/
+→ Moving project root docs to .ai-flow/temp-backup/
 
 Files to backup:
 ✅ project-brief.md
@@ -437,17 +437,174 @@ npx prisma init
   - MySQL: https://hub.docker.com/_/mysql
   - MongoDB: https://hub.docker.com/_/mongo
 
-### 8.2.6.5: Final Summary
+### 8.2.6.5: Generate .gitignore
+
+**IMPORTANT:** Generate a comprehensive `.gitignore` file based on the framework, language, and tools selected in previous phases.
+
+```
+📝 Generating .gitignore for your tech stack...
+```
+
+**Strategy:**
+
+1. **Detect framework from Phase 3** (NestJS, Express, Django, FastAPI, etc.)
+2. **Detect language** (Node.js, Python, Go, etc.)
+3. **Detect tools from Phase 7** (Docker, Prisma, etc.)
+4. **Combine relevant patterns**
+
+**Base patterns by technology:**
+
+**Node.js projects (NestJS, Express):**
+
+```gitignore
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# Build outputs
+dist/
+build/
+*.tsbuildinfo
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+coverage/
+.nyc_output/
+
+# Logs
+logs/
+*.log
+
+# Prisma (if using)
+prisma/migrations/dev.db
+prisma/*.db
+
+# TypeScript
+*.tsbuildinfo
+```
+
+**Python projects (Django, FastAPI):**
+
+```gitignore
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# Django
+*.log
+db.sqlite3
+db.sqlite3-journal
+media/
+staticfiles/
+
+# FastAPI
+.pytest_cache/
+
+# Environment
+.env
+.env.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+```
+
+**Go projects:**
+
+```gitignore
+# Binaries
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+bin/
+
+# Test binary
+*.test
+
+# Output
+*.out
+
+# Go workspace
+go.work
+
+# Environment
+.env
+
+# IDE
+.vscode/
+.idea/
+```
+
+**Docker additions (if Docker selected in Phase 7):**
+
+```gitignore
+# Docker
+docker-compose.override.yml
+.docker/
+```
+
+**📝 Action:** Generate and write `.gitignore` to project root.
+
+**Selection logic:**
+
+- If NestJS/Express → Use Node.js patterns
+- If Django/FastAPI → Use Python patterns
+- If Go/Gin → Use Go patterns
+- If Prisma detected in Phase 3 → Add Prisma patterns
+- If Docker selected in Phase 7 → Add Docker patterns
+
+```
+✅ Generated: .gitignore
+   Patterns included: [Node.js | Python | Go] + [Prisma] + [Docker]
+```
+
+---
+
+### 8.2.6.6: Final Summary
 
 ```
 ✅ Minimal enhancements complete!
 
-Files created (2-3 max):
+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: 2-3 files (vs 40-60 files in old approach)
+🎯 Total: 3-4 files (vs 40-60 files in old approach)
 📚 For Express/FastAPI starter code, refer to official documentation
 
 Next steps:
@@ -465,7 +622,7 @@ Next steps:
 - ❌ **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
+- ✅ **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
 
@@ -532,6 +689,14 @@ Generating...
 [Generate mermaid sequence diagram]
 ```
 
+**📝 Action:** Write the complete file to `docs/business-flows.md`
+
+```
+✅ Generated: docs/business-flows.md
+```
+
+---
+
 ### 8.3.2: Generate docs/api.md
 
 - **Template:** `.ai-flow/templates/docs/api.template.md`
@@ -608,6 +773,12 @@ We use [workflow from Phase 5]
 [Format from Phase 5.2]
 ````
 
+**📝 Action:** Write the complete file to `docs/contributing.md`
+
+```
+✅ Generated: docs/contributing.md
+```
+
 ---
 
 ## 8.4: Generate AGENT.md (Master Index)
@@ -759,15 +930,50 @@ The API will be available at `http://localhost:3000`
 
 ````
 
-**Success message:**
+**📝 Action:** Write the complete file to `.ai-flow/README.md`
 
 ```
-✅ README.md generated!
+✅ Generated: .ai-flow/README.md
    [If merged] Merged with framework's setup instructions
 ```
 
 ---
 
+## 8.6: Generate AGENT.md (Master Index)
+
+**CRITICAL:** Before generating AGENT.md, re-read ALL previously generated documents to have complete context.
+
+**📝 Action:**
+
+```
+🔄 Re-reading all generated documents for AGENT.md generation...
+
+✅ Reading project-brief.md
+✅ Reading ai-instructions.md
+✅ Reading docs/data-model.md
+✅ Reading docs/architecture.md
+✅ Reading docs/code-standards.md
+✅ Reading docs/testing.md
+✅ Reading docs/operations.md
+✅ Reading specs/security.md
+✅ Reading specs/configuration.md
+✅ Reading docs/business-flows.md
+✅ Reading docs/api.md
+✅ Reading docs/contributing.md
+
+✅ All context loaded!
+```
+
+Now generate AGENT.md with complete information from all documents.
+
+**📝 Action:** Write the complete file to `.ai-flow/AGENT.md`
+
+```
+✅ Generated: .ai-flow/AGENT.md (Master Index)
+```
+
+---
+
 ## 8.7: Create Tool-Specific Configs
 
 **Based on AI tool selection from Phase 3 (question 3.8):**
@@ -789,18 +995,18 @@ Read `.ai-flow/AGENT.md` first for complete documentation index.
 
 - Project overview: `.ai-flow/project-brief.md`
 - AI instructions: `.ai-flow/ai-instructions.md`
-- Architecture: `.ai-flow/docs/architecture.md`
-- API reference: `.ai-flow/docs/api.md`
-- Code standards: `.ai-flow/docs/code-standards.md`
+- Architecture: `docs/architecture.md`
+- API reference: `docs/api.md`
+- Code standards: `docs/code-standards.md`
 
 ## Working Instructions
 
 When writing code:
 
-1. Follow patterns in `.ai-flow/docs/code-standards.md`
-2. Reference data model in `.ai-flow/docs/data-model.md`
-3. Implement security rules from `.ai-flow/specs/security.md`
-4. Write tests per `.ai-flow/docs/testing.md`
+1. Follow patterns in `docs/code-standards.md`
+2. Reference data model in `docs/data-model.md`
+3. Implement security rules from `specs/security.md`
+4. Write tests per `docs/testing.md`
 
 ## Critical Rules
 
@@ -823,9 +1029,9 @@ See `.ai-flow/AGENT.md` for complete document list.
 ## Quick Reference
 
 - Tech Stack: [from Phase 3]
-- Architecture: `.ai-flow/docs/architecture.md`
-- Code Standards: `.ai-flow/docs/code-standards.md`
-- API Conventions: `.ai-flow/docs/api.md`
+- Architecture: `docs/architecture.md`
+- Code Standards: `docs/code-standards.md`
+- API Conventions: `docs/api.md`
 
 ## Code Generation Rules
 
@@ -855,11 +1061,11 @@ Master index: `.ai-flow/AGENT.md`
 
 ## Key References
 
-- Architecture: `.ai-flow/docs/architecture.md`
-- Data Model: `.ai-flow/docs/data-model.md`
-- API: `.ai-flow/docs/api.md`
-- Code Standards: `.ai-flow/docs/code-standards.md`
-- Testing: `.ai-flow/docs/testing.md`
+- Architecture: `docs/architecture.md`
+- Data Model: `docs/data-model.md`
+- API: `docs/api.md`
+- Code Standards: `docs/code-standards.md`
+- Testing: `docs/testing.md`
 
 ## Code Generation Guidelines
 
@@ -874,9 +1080,17 @@ Master index: `.ai-flow/AGENT.md`
 [Extract from code-standards.md]
 ```
 
-### If "All" selected:
+**📝 Action:** Generate the tool-specific config files based on selection:
 
-Generate all three files above.
+- If Claude → Write `.clauderules`
+- If Cursor → Write `.cursorrules`
+- If Copilot → Write `.github/copilot-instructions.md`
+- If "All" → Write all three files
+
+```
+✅ Generated tool-specific configs:
+   [List generated files based on selection]
+```
 
 ---
 
@@ -898,7 +1112,7 @@ All validations passed!
 ```
 🎉 AI Flow Complete!
 
-Generated 15 documents successfully:
+Generated 16 documents successfully:
 
 Phase 1:
 ✅ project-brief.md
@@ -930,6 +1144,7 @@ Phase 8:
 ✅ docs/contributing.md
 ✅ README.md
 ✅ AGENT.md
+✅ .gitignore
 
 [If framework initialized:]
 ✅ [FRAMEWORK_NAME] project initialized
@@ -959,13 +1174,14 @@ your-project/
 │ │ ├── testing.md
 │ │ ├── operations.md
 │ │ └── contributing.md
-│ ├── specs/
-│ │ ├── security.md
-│ │ └── configuration.md
+├── specs/
+│ ├── security.md
+│ └── configuration.md
 │ └── templates/ # Original templates
 ├── [framework files] # If initialized
 ├── README.md
 ├── .env.example
+├── .gitignore
 └── [tool configs] # .clauderules, .cursorrules, etc.
 
 ````
@@ -1037,11 +1253,12 @@ 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:**
 
 - [ ] Re-read ALL documents again to ensure accuracy
-- [ ] Create master index listing all 15 documents
+- [ ] Create master index listing all 16 documents
 - [ ] Include quick reference (tech stack, rules, commands)
 - [ ] Validate all links
 
@@ -1136,7 +1353,7 @@ Your choice (A/B): \_\_
 
 ```
 
-**If choice A:** Continue to Phase 9 (flow-bootstrap-phase-9.md)
+**If choice A:** Continue to Phase 9 (flow-build-phase-9.md)
 
 **If choice B:** Show completion message:
 
@@ -1165,3 +1382,4 @@ Happy coding! 🚀
 
 **SUCCESS:** Project fully documented and ready for development! 🚀
 ```
+