ai-flow-dev 2.1.6 → 2.1.8

package/prompts/frontend/flow-docs-sync.md

@@ -1,15 +1,19 @@
+---
+description: Documentation Sync & Update Flow
+---
+
 # AI Flow - Documentation Update Command (Frontend)
 
 **YOU ARE AN EXPERT FRONTEND ARCHITECT AND DOCUMENTATION SPECIALIST.**
 
 Your mission is to detect changes in the frontend codebase and update the project documentation automatically when the user executes `/flow-docs-sync`.
----
+---
 ## Command: `/flow-docs-sync`
 
 ### Objective
 
 Detect changes in the frontend codebase compared to the last documented state (stored in `.ai-flow/cache/docs-analysis.json`) and update all affected documentation files automatically.
----
+---
 ## Execution Flow
 
 ### Step 1: Check for Analysis File
@@ -182,7 +186,7 @@ No updates required.
 ```
 Update cancelled. Run `/flow-docs-sync` when you're ready to update the documentation.
 ```
----
+---
 ## Change Detection Rules
 
 ### Components Detection
@@ -274,7 +278,7 @@ Update cancelled. Run `/flow-docs-sync` when you're ready to update the document
 
 - Add new variables to configuration spec
 - Maintain existing variables
----
+---
 ## Important Rules
 
 1. **Incremental Updates Only:**
@@ -300,7 +304,7 @@ Update cancelled. Run `/flow-docs-sync` when you're ready to update the document
    - Regenerate component architecture diagrams when structure changes
    - Regenerate architecture diagrams when structure changes
    - Use mermaid format for all diagrams
----
+---
 ## 📊 FRONTEND DIAGRAM REGENERATION GUIDELINES
 
 When regenerating frontend diagrams, follow these **critical** formatting rules:
@@ -354,7 +358,7 @@ graph TD
     style Btn fill:#fce4ec
 ```
 ````
----
+---
 ### State Management Diagrams (state-management.md)
 
 **Diagram Types:** `graph LR`, `sequenceDiagram`, `graph TD`
@@ -398,7 +402,7 @@ sequenceDiagram
     Component-->>User: UI Updated
 ```
 ````
----
+---
 ### Routing Diagrams (architecture.md or routing.md)
 
 **Diagram Type:** `graph TD`
@@ -417,7 +421,7 @@ sequenceDiagram
 - [ ] Nested routes show parent-child relationships
 - [ ] Route parameters are documented
 - [ ] Diagram matches actual router configuration
----
+---
 ### Application Architecture Diagram (architecture.md)
 
 **Diagram Type:** `graph TB`
@@ -458,7 +462,7 @@ graph TB
 ````
 
 **Use for:** System architecture overview, integration documentation, onboarding
----
+---
 ### Common Formatting Rules (ALL Frontend Diagrams)
 
 **CRITICAL - Code Fence Syntax:**
@@ -492,12 +496,12 @@ graph TB
 3. Maintain existing styling and layout patterns
 4. Update relationships based on code changes
 5. Verify entire diagram still renders after changes
----
+---
 5. **Error Handling:**
    - If document doesn't exist, create it following template
    - If docs-analysis.json is corrupted, regenerate it
    - If comparison fails, show error and suggest full Phase 0 re-run
----
+---
 ## Example Execution
 
 ```
@@ -531,7 +535,7 @@ AI:
 
 Documentation synchronized successfully.
 ```
----
+---
 **BEGIN EXECUTION when user runs `/flow-docs-sync`**
 
 

package/prompts/mobile/flow-build-phase-1.md

@@ -1,21 +1,157 @@
 # Phase 1: Platform & Framework Selection
 
 **Duration:** 20-25 minutes
-**Questions:** ~15 questions
+**Questions:** ~17 questions
 **Output:** project-brief.md, parts of AGENT.md, parts of ai-instructions.md
----
+---
 ## 🎯 Objective
 
-Determine the **technical foundation** for your mobile application:
+Determine the **business goal and technical foundation** for your mobile application:
 
-1. What platforms will you target?
-2. What framework will you use?
-3. What minimum OS versions will you support?
-4. What development tools and languages?
----
+1. What is the core goal and purpose of the project?
+2. What platforms will you target?
+3. What framework will you use?
+4. What minimum OS versions will you support?
+5. What development tools and languages?
+---
 ## 📋 Questions
 
-### Question 1.1: Target Platforms
+### Question 1.1: Project Name & Description (with Smart Refinement)
+
+> **🧠 Intelligent Refinement System**: This question detects vague descriptions and guides the developer to enrich them. It only asks what's missing and responds in the developer's language.
+
+```
+What is the project name?
+
+Provide an initial description of your project.
+(Don't worry about perfection - we'll refine it together if needed!)
+
+Example: "A native iOS app for tracking wildlife sightings in the Amazon"
+```
+
+**🔍 AI Internal: Ambiguity Analysis**
+
+After receiving the description, silently analyze for these criteria:
+
+| Criterion | Check For | Score +1 if present |
+|-----------|-----------|---------------------|
+| **WHO** | Specific user type mentioned (not just "users") | "tourists", "researchers", "drivers" |
+| **WHAT** | Specific action/function (not just "app", "system") | "scan barcodes", "record audio", "track GPS" |
+| **WHY** | Purpose or value mentioned | "to protect species", "to optimize routes" |
+| **DOMAIN** | Industry/vertical indicated | "environmental", "logistics", "social" |
+| **DETAIL** | Description has 10+ meaningful words | Not counting articles |
+
+**Scoring Rules:**
+- Score 4-5: ✅ Accept immediately → Proceed to 1.2
+- Score 0-3: ⚠️ Enter refinement loop → Ask ONLY missing criteria
+
+---
+
+**🔄 Conditional Refinement Loop (only if score < 4)**
+
+> **CRITICAL**: Only ask about criteria that are MISSING. Do NOT repeat questions already answered. Respond in the SAME LANGUAGE the developer used.
+
+```
+[LANGUAGE: Match the developer's language]
+
+🔍 I'd like to understand your project better.
+
+Your description: "[original description]"
+
+[ONLY show questions for MISSING criteria:]
+
+[If WHO is missing:]
+1️⃣ WHO will use this mobile app?
+   A) End consumers (App Store/Play Store)
+   B) Internal employees (Enterprise)
+   C) Partners/Contractors
+   D) Other: __
+
+[If WHAT is missing:]
+2️⃣ WHAT is the core mobile action users will perform?
+   A) Transactional (Buy/Sell)
+   B) Utility (Tools/Monitoring)
+   C) Social (Chat/Share)
+   D) Media (Photo/Video)
+   E) Informational (News/Content)
+   F) Other: __
+
+[If WHY is missing:]
+3️⃣ WHY is this mobile project needed?
+   A) New product launch
+   B) Companion to web app
+   C) Offline-first requirement
+   D) Better mobile performance
+   E) Other: __
+
+[If DOMAIN is missing:]
+4️⃣ What INDUSTRY/DOMAIN is this for?
+   A) E-commerce/Retail
+   B) Fitness/Health
+   C) Finance/Payments
+   D) Education/Learning
+   E) Social/Community
+   F) Business tools (CRM, ERP)
+   G) Other: __
+
+Your answers: __
+```
+
+---
+
+**✨ Generate Professional Description Options**
+
+After gathering missing info, generate 3 polished versions:
+
+```
+[LANGUAGE: Match the developer's language]
+
+✨ Based on your input, here are 3 professional descriptions:
+
+A) Concise (for App Store subtitle):
+   "[Generated 1-line description]"
+
+B) Descriptive (for README.md):
+   "[Generated 2-3 line description with Mobile focus]"
+
+C) User-centric (for Marketing):
+   "[Generated benefit-driven description]"
+
+Which do you prefer? (1-3, or 4 to edit, 5 to start over)
+```
+
+**Your choice:**
+
+---
+
+### Question 1.2: Project Overview (Confirmation + Expansion)
+
+> **📌 Smart Skip**: If 1.1 already captured WHO/WHAT/WHY completely, this becomes a quick confirmation.
+
+```
+[If 1.1 refinement was complete (score >= 4), show:]
+
+✅ Based on your description, I understand:
+   • Users: [WHO from 1.1]
+   • Goal: [WHAT from 1.1]
+   • Need: [WHY from 1.1]
+
+Is this correct? (Y) Or would you like to add more context? (N)
+
+---
+
+[If 1.1 was NOT refined OR missing elements, ask:]
+
+Briefly describe the core problem this app solves:
+- Who are the primary users?
+- What is the main benefit?
+- Why build a mobile app instead of a web app?
+```
+
+**Your answer:**
+
+---
+### Question 1.3: Target Platforms
 
 **What platforms will your app support?**
 
@@ -44,8 +180,8 @@ D) **iOS + Android + Web (Universal)**
 - Best for: Multi-platform presence
 
 **Your answer:**
----
-### Question 1.2: Mobile Framework
+---
+### Question 1.4: Mobile Framework
 
 **What framework will you use to build your mobile app?**
 
@@ -100,8 +236,8 @@ D) **iOS + Android + Web (Universal)**
 
 - What Flutter version? (Latest stable recommended)
 - Will you use Flutter for Web/Desktop too? (Y/n)
----
-### Question 1.3: Minimum OS Versions
+---
+### Question 1.5: Minimum OS Versions
 
 **What minimum OS versions will you support?**
 
@@ -150,8 +286,8 @@ D) **iOS + Android + Web (Universal)**
   - Best for: Premium apps, latest tech
 
 **Your answer:**
----
-### Question 1.4: Programming Language
+---
+### Question 1.6: Programming Language
 
 **What programming language will you use?**
 
@@ -192,8 +328,8 @@ D) **iOS + Android + Web (Universal)**
   - Best for: Maintaining existing apps
 
 **Your answer:**
----
-### Question 1.5: Development Environment
+---
+### Question 1.7: Development Environment
 
 **What development tools will you use?**
 
@@ -222,8 +358,8 @@ D) **iOS + Android + Web (Universal)**
 - **Dart DevTools** - Debugging (Flutter)
 
 **Your answer:**
----
-### Question 1.6: Package Manager
+---
+### Question 1.8: Package Manager
 
 **What package manager will you use?**
 
@@ -246,8 +382,8 @@ D) **iOS + Android + Web (Universal)**
 - **Gradle** (built-in)
 
 **Your answer:**
----
-### Question 1.7: Build Tools & CI/CD
+---
+### Question 1.9: Build Tools & CI/CD
 
 **What build and deployment tools will you use?**
 
@@ -278,8 +414,8 @@ E) **Manual Builds**
 - Best for: Learning, small projects
 
 **Your answer:**
----
-### Question 1.8: Code Signing Strategy
+---
+### Question 1.10: Code Signing Strategy
 
 **How will you handle code signing?**
 
@@ -304,8 +440,8 @@ E) **Manual Builds**
   - Required for some enterprise scenarios
 
 **Your answer:**
----
-### Question 1.9: App Store Accounts
+---
+### Question 1.11: App Store Accounts
 
 **Do you have App Store accounts set up?**
 
@@ -321,8 +457,8 @@ E) **Manual Builds**
 - B) ❌ **No, will set up later**
 
 **Your answer:**
----
-### Question 1.10: Beta Testing Strategy
+---
+### Question 1.12: Beta Testing Strategy
 
 **How will you handle beta testing?**
 
@@ -347,8 +483,8 @@ D) **No Beta Testing**
 - Best for: MVPs, internal apps
 
 **Your answer:**
----
-### Question 1.11: Analytics & Crash Reporting
+---
+### Question 1.13: Analytics & Crash Reporting
 
 **What analytics and crash reporting will you use?**
 
@@ -374,8 +510,8 @@ D) **No Analytics**
 - Best for: Privacy-critical apps
 
 **Your answer:**
----
-### Question 1.12: UI/UX Framework
+---
+### Question 1.14: UI/UX Framework
 
 **What UI/UX framework or design system will you use?**
 
@@ -422,8 +558,8 @@ D) **No Analytics**
 
 - Will you use platform-specific UI? (iOS uses Cupertino, Android uses Material)
 - Or unified design across platforms?
----
-### Question 1.13: Theme & Dark Mode
+---
+### Question 1.15: Theme & Dark Mode
 
 **Will your app support dark mode?**
 
@@ -443,8 +579,8 @@ C) **No Dark Mode**
 - Best for: Simple apps
 
 **Your answer:**
----
-### Question 1.14: Internationalization (i18n)
+---
+### Question 1.16: Internationalization (i18n)
 
 **Will your app support multiple languages?**
 
@@ -471,8 +607,8 @@ C) **No Internationalization**
   - React Native: react-i18next, react-native-localize
   - Flutter: intl, easy_localization
   - Native: NSLocalizedString (iOS), Resources (Android)
----
-### Question 1.15: Image & Asset Management
+---
+### Question 1.17: Image & Asset Management
 
 **How will you handle images and assets?**
 
@@ -500,48 +636,46 @@ C) **All Remote Images**
   - React Native: react-native-fast-image, react-native-image-caching
   - Flutter: cached_network_image
   - Native: SDWebImage (iOS), Glide (Android)
----
+---
 ## ✅ Phase 1 Completion
 
 After answering all questions, summarize:
 
 ```
----
+---
 ✅ Phase 1 Complete: Platform & Framework Selection
----
+---
+Project Name: [Answer from 1.1]
+Project Description: [Answer from 1.1]
 Selected Stack:
-- Platforms: iOS + Android
-- Framework: React Native 0.72.0
-- Language: TypeScript
-- Minimum iOS: 15.0+
-- Minimum Android: API 26 (Android 8.0)+
-- Package Manager: npm
-- Build Tools: Fastlane
-- Analytics: Firebase Analytics + Crashlytics
-- UI Framework: React Native Paper
-- Dark Mode: System Theme
-- Internationalization: Multiple Languages (react-i18next)
-- Image Management: Local Assets + Remote Images
+- Platforms: [Answer from 1.3]
+- Framework: [Answer from 1.4]
+- Language: [Answer from 1.6]
+- Minimum iOS: [Answer from 1.5]
+- Minimum Android: [Answer from 1.5]
+- Package Manager: [Answer from 1.8]
+- Build Tools: [Answer from 1.9]
+- Analytics: [Answer from 1.13]
+- UI Framework: [Answer from 1.14]
+- Dark Mode: [Answer from 1.15]
+- Internationalization: [Answer from 1.16]
+- Image Management: [Answer from 1.17]
 
 Proceed to Phase 2 (Navigation & Architecture)? (Y/n)
 ```
----
+---
 ## 📝 Generated Documents
 
 After Phase 1, generate/update:
 
-- `project-brief.md` - Add platform and framework information
+- `project-brief.md` - Add project goal, platforms, and framework information
 - `AGENT.md` - Update technical context section
 - `ai-instructions.md` - Add framework-specific rules and setup
----
+---
 **Next Phase:** Phase 2 - Navigation & Architecture
 
 Read: `.ai-flow/prompts/mobile/flow-build-phase-2-navigation.md`
----
-**Last Updated:** 2025-01-XX
-
-**Version:** 1.4.0
-
-
-
+---
+**Last Updated:** 2025-12-XX
 
+**Version:** 1.5.0