ai-flow-dev 2.2.0 → 2.2.1

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

@@ -1,32 +1,54 @@
-# Phase 1: Platform & Framework Selection
+## PHASE 1: Discovery & Business (15-20 min)
+
+> **Order for this phase:** 1.1 → 1.2 → 1.3 → 1.4 → 1.5 → 1.6 → 1.7 → 1.8 → 1.9 → 1.10
+
+> **📌 Scope-based behavior:**
+> - **MVP/Basic Scope:** Focus only on core requirements. Skip advanced business logic questions.
+> - **Production-Ready Scope:** In-depth exploration of compliance, scalability, and long-term business goals.
+
+### Objective
+Define the project's core purpose, business rules, and high-level requirements to ensure the foundation is solid before technical design begins.
 
-**Duration:** 20-25 minutes
-**Questions:** ~17 questions
-**Output:** project-brief.md, parts of AGENT.md, parts of ai-instructions.md
 ---
-## 🎯 Objective
 
-Determine the **business goal and technical foundation** for your mobile application:
+## 🔍 Pre-Flight Check (Smart Skip Logic)
+
+> 📎 **Reference:** See [prompts/shared/smart-skip-preflight.md](../shared/smart-skip-preflight.md) for the complete smart skip logic.
+
+**Execute Pre-Flight Check for Phase 1:**
+
+- **Target File**: `project-brief.md`
+- **Phase Name**: "BUSINESS CONTEXT"
+- **Key Items**: Project name, description, users, objectives, system type, features, scope, constraints, metrics, business flows
+- **Typical Gaps**: Business objectives, success metrics, constraints
+
+**Proceed with appropriate scenario based on audit data from `.ai-flow/cache/audit-data.json`**
 
-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: Project Name & Description (with Smart Refinement)
+## Phase 1 Questions (Full Mode)
+
+> **📌 Note:** If Phase 0 was executed, some questions may already be answered. Skip those and only ask what's missing.
+
+**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.
 
 ```
+[If detected from Phase 0, show:]
+✅ Project Name: [detected name]
+✅ Description: [detected description]
+
+Is this correct? (Y/N)
+If no, please provide correct values.
+
+[If NOT detected, ask:]
 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"
+Example: "A backend for managing gym memberships"
 ```
 
 **🔍 AI Internal: Ambiguity Analysis**
@@ -35,10 +57,10 @@ 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" |
+| **WHO** | Specific user type mentioned (not just "users") | "gym members", "restaurant owners" |
+| **WHAT** | Specific action/function (not just "manage") | "track workouts", "process payments" |
+| **WHY** | Purpose or value mentioned | "to replace spreadsheets", "to launch app" |
+| **DOMAIN** | Industry/vertical indicated | "fitness", "fintech", "healthcare" |
 | **DETAIL** | Description has 10+ meaningful words | Not counting articles |
 
 **Scoring Rules:**
@@ -61,27 +83,28 @@ 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: __
+1️⃣ WHO will use this system?
+   A) End consumers (B2C)
+   B) Business users (B2B)
+   C) Internal team
+   D) Other systems (APIs)
+   E) 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)
+2️⃣ WHAT is the core action users will perform?
+   A) Buy/sell products or services
+   B) Manage/organize information
+   C) Communicate/collaborate
+   D) Monitor/analyze data
+   E) Create/publish 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
+3️⃣ WHY is this project needed?
+   A) Replace manual/legacy process
+   B) Launch new product/business
+   C) Improve existing system
+   D) Enable new capability
    E) Other: __
 
 [If DOMAIN is missing:]
@@ -89,12 +112,12 @@ Your description: "[original description]"
    A) E-commerce/Retail
    B) Fitness/Health
    C) Finance/Payments
-   D) Education/Learning
+   D) Education
    E) Social/Community
    F) Business tools (CRM, ERP)
    G) Other: __
 
-Your answers: __
+Your answers: __ (e.g., "A, B, A, E" or describe freely)
 ```
 
 ---
@@ -108,574 +131,496 @@ After gathering missing info, generate 3 polished versions:
 
 ✨ Based on your input, here are 3 professional descriptions:
 
-A) Concise (for App Store subtitle):
-   "[Generated 1-line description]"
+A) Concise (for package.json):
+   "[Generated 1-line description with WHO + WHAT]"
 
 B) Descriptive (for README.md):
-   "[Generated 2-3 line description with Mobile focus]"
+   "[Generated 2-3 line description with WHO + WHAT + WHY]"
 
-C) User-centric (for Marketing):
-   "[Generated benefit-driven description]"
+C) Technical (for AGENT.md):
+   "[Generated technical description with DOMAIN + WHAT]"
 
 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.
+**✅ Final Confirmation**
 
 ```
-[If 1.1 refinement was complete (score >= 4), show:]
+✅ Your final project description:
 
-✅ Based on your description, I understand:
-   • Users: [WHO from 1.1]
-   • Goal: [WHAT from 1.1]
-   • Need: [WHY from 1.1]
+📋 Name: [project name]
+📝 Description: "[final polished description]"
 
-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?
+Proceed to next question? (Y to continue)
 ```
 
-**Your answer:**
-
 ---
-### Question 1.3: Target Platforms
 
-**What platforms will your app support?**
+**1.2 Project Overview (Confirmation + Expansion)**
 
-A) ⭐ **iOS Only**
-
-- Apple App Store only
-- Swift or React Native iOS
-- Best for: Apple-focused products, faster initial launch
-
-B) ⭐ **Android Only**
-
-- Google Play Store only
-- Kotlin or React Native Android
-- Best for: Android-focused products, wider market reach
+> **📌 Smart Skip**: If 1.1 already captured WHO/WHAT/WHY completely, this becomes a quick confirmation.
 
-C) 🔥 **iOS + Android (Cross-Platform)** (Recommended)
+```
+[If 1.1 refinement was complete (score >= 4), show:]
 
-- Both App Store and Play Store
-- React Native, Flutter, or Ionic
-- Best for: Maximum reach, shared codebase
+✅ Based on your description, I understand:
+   • Users: [WHO from 1.1]
+   • Core Action: [WHAT from 1.1]
+   • Purpose: [WHY from 1.1]
 
-D) **iOS + Android + Web (Universal)**
+Is this complete? (Y) Or would you like to add more context? (N)
 
-- Mobile apps + web version
-- React Native Web, Flutter Web, or PWA
-- Best for: Multi-platform presence
+[If user says Y → Skip to 1.3]
+[If user says N → Ask:]
+What additional context would you like to add?
 
-**Your answer:**
 ---
-### Question 1.4: Mobile Framework
-
-**What framework will you use to build your mobile app?**
-
-**If iOS Only:**
-
-- A) ⭐ **Native iOS (Swift)** - Best performance, full native features
-- B) **Native iOS (Objective-C)** - Legacy support
-- C) **React Native** - Cross-platform, JavaScript
-- D) **Flutter** - Cross-platform, Dart
-
-**If Android Only:**
 
-- A) ⭐ **Native Android (Kotlin)** - Best performance, full native features
-- B) **Native Android (Java)** - Legacy support
-- C) **React Native** - Cross-platform, JavaScript
-- D) **Flutter** - Cross-platform, Dart
+[If 1.1 was NOT refined OR any WHO/WHAT/WHY still missing, ask:]
 
-**If Cross-Platform:**
+[ONLY ask for MISSING elements - check what was NOT captured in 1.1:]
 
-- A) ⭐ **React Native** (Recommended)
-  - JavaScript/TypeScript
-  - Large ecosystem
-  - Hot reload
-  - Best for: Teams familiar with React
+[If WHO still unclear:]
+Who are the primary users of this system?
 
-- B) 🔥 **Flutter** (Popular)
-  - Dart language
-  - Excellent performance
-  - Beautiful UI out of the box
-  - Best for: Teams wanting native-like performance
+[If WHAT still unclear:]
+What is the core value proposition?
 
-- C) **Ionic**
-  - Web technologies (HTML/CSS/JS)
-  - Capacitor for native features
-  - Best for: Web developers transitioning to mobile
+[If WHY still unclear:]
+What makes this project necessary?
 
-- D) **Xamarin / .NET MAUI**
-  - C# language
-  - Microsoft ecosystem
-  - Best for: .NET teams
-
-**Your answer:**
-
-**If React Native selected, ask:**
-
-- What React Native version? (Latest stable recommended)
-- Will you use Expo? (Y/n)
-  - Expo: Faster development, managed workflow
-  - Bare React Native: More control, custom native code
-
-**If Flutter selected, ask:**
-
-- What Flutter version? (Latest stable recommended)
-- Will you use Flutter for Web/Desktop too? (Y/n)
----
-### Question 1.5: Minimum OS Versions
-
-**What minimum OS versions will you support?**
-
-**For iOS:**
-
-- A) ⭐ **iOS 15+** (Recommended)
-  - Covers ~95% of active devices
-  - Modern APIs available
-  - Best for: Most apps
-
-- B) **iOS 14+**
-  - Covers ~98% of active devices
-  - Some older APIs needed
-  - Best for: Maximum compatibility
-
-- C) **iOS 16+**
-  - Covers ~85% of active devices
-  - Latest features only
-  - Best for: New apps, modern features
+Example:
+"A backend for a fitness tracking mobile app used by gym-goers (users). It allows users to log workouts, track progress over time, and share achievements with friends (value). This project is necessary to replace our legacy spreadsheet-based system and support our new iOS app launch."
+```
 
-- D) **iOS 17+**
-  - Covers ~60% of active devices
-  - Cutting-edge features
-  - Best for: Premium apps, latest tech
+**1.3 Target Users (Confirmation + Additional Types)**
 
-**For Android:**
+> **📌 Smart Skip**: If 1.1 already identified user types, this confirms and expands.
 
-- A) ⭐ **Android 8.0 (API 26)+** (Recommended)
-  - Covers ~95% of active devices
-  - Modern APIs available
-  - Best for: Most apps
+```
+[If WHO was captured in 1.1, show:]
 
-- B) **Android 7.0 (API 24)+**
-  - Covers ~98% of active devices
-  - Some older APIs needed
-  - Best for: Maximum compatibility
+✅ Based on your description, your target users are: [WHO from 1.1]
 
-- C) **Android 10 (API 29)+**
-  - Covers ~85% of active devices
-  - Latest features only
-  - Best for: New apps, modern features
+Would you like to add any additional user types? Select any that apply:
 
-- D) **Android 12 (API 31)+**
-  - Covers ~70% of active devices
-  - Cutting-edge features
-  - Best for: Premium apps, latest tech
+A) 🌐 External end-users (B2C) - Public-facing application
+B) 🏢 Internal employees (B2B/Enterprise) - Company internal tool
+C) 🔌 Other systems/services (API consumers) - Integration platform
+D) 👥 Partners/Third-parties - Partner ecosystem
+E) 📱 Mobile/Web apps - Backend for frontend
+F) ✅ No additional users - [WHO from 1.1] is complete
 
-**Your answer:**
 ---
-### Question 1.6: Programming Language
 
-**What programming language will you use?**
+[If WHO was NOT captured in 1.1, ask normally:]
 
-**If React Native:**
+Who will use this system? Select all that apply:
 
-- A) ⭐ **TypeScript** (Recommended)
-  - Type safety
-  - Better IDE support
-  - Industry standard
+A) 🌐 External end-users (B2C) - Public-facing application
+B) 🏢 Internal employees (B2B/Enterprise) - Company internal tool
+C) 🔌 Other systems/services (API consumers) - Integration platform
+D) 👥 Partners/Third-parties - Partner ecosystem
+E) 📱 Mobile/Web apps - Backend for frontend
 
-- B) **JavaScript**
-  - Faster initial development
-  - Less boilerplate
-  - Best for: Small projects, rapid prototyping
+(Can select multiple)
+```
 
-**If Flutter:**
+**1.4 Business Objectives**
 
-- **Dart** (Required - Flutter uses Dart)
+```
+What are the top 3 measurable objectives for this project?
+
+Examples:
+- Process 10,000 transactions/day
+- Reduce customer onboarding time by 50%
+- Support 1M active users
+- Achieve 99.9% uptime SLA
+
+Your objectives:
+1.
+2.
+3.
+```
 
-**If Native iOS:**
+**1.5 System Type (Confirmation + Validation)**
 
-- A) ⭐ **Swift** (Recommended)
-  - Modern, safe language
-  - Apple's preferred language
+> **📌 Smart Skip**: If 1.1 already identified the domain/industry, this confirms it.
 
-- B) **Objective-C**
-  - Legacy support
-  - Best for: Maintaining existing apps
+```
+[If DOMAIN was captured in 1.1, show:]
 
-**If Native Android:**
+✅ Based on your description, this appears to be a: [DOMAIN from 1.1] system
 
-- A) ⭐ **Kotlin** (Recommended)
-  - Modern, concise language
-  - Google's preferred language
+Is this correct?
 
-- B) **Java**
-  - Legacy support
-  - Best for: Maintaining existing apps
+A) ✅ Yes, that's correct
+B) 🔄 No, it's actually: [show options below]
 
-**Your answer:**
 ---
-### Question 1.7: Development Environment
-
-**What development tools will you use?**
 
-**For iOS Development:**
+[If DOMAIN was NOT captured in 1.1, OR user selected B above:]
 
-- A) ⭐ **Xcode** (Required for iOS)
-  - Version: Latest stable (15.x)
-  - Includes iOS Simulator
-  - Interface Builder, Instruments
+What type of system are you building? (This helps suggest common features)
 
-**For Android Development:**
+A) 🛒 E-commerce/Marketplace
+B) 📱 SaaS/B2B Platform
+C) 📊 CRM/ERP/Business Tool
+D) 🎮 Social/Community Platform
+E) 📋 Content Management
+F) 🏦 FinTech/Payment
+G) 🏥 Healthcare/Booking
+H) 📚 Education/Learning
+I) 🔧 DevTools/API Platform
+J) Other: __
 
-- A) ⭐ **Android Studio** (Required for Android)
-  - Version: Latest stable
-  - Includes Android Emulator
-  - Gradle build system
-
-**For Cross-Platform:**
-
-- **VS Code** or **Android Studio** / **Xcode** (for native modules)
-
-**Additional Tools:**
-
-- **Flipper** - Debugging tool (React Native)
-- **React Native Debugger** - Debugging (React Native)
-- **Dart DevTools** - Debugging (Flutter)
-
-**Your answer:**
----
-### Question 1.8: Package Manager
-
-**What package manager will you use?**
-
-**If React Native:**
-
-- A) ⭐ **npm** (Recommended)
-- B) **yarn**
-- C) **pnpm**
+Your choice: __
+```
 
-**If Flutter:**
+**1.6 Core Features**
 
-- **pub** (Flutter's built-in package manager)
+```
+What are the main functionalities your system needs?
+
+Think about what your users will be able to do with your system. You can list them freely, or select from common features suggested below based on your system type.
+
+🛒 E-commerce common features:
+1) User authentication (register/login)
+2) Product catalog with search/filters
+3) Shopping cart
+4) Checkout and payment processing
+5) Order management
+6) Inventory tracking
+7) Admin dashboard
+📱 SaaS common features:
+1) User authentication with SSO
+2) Multi-tenant organization/workspace management
+3) Role-based access control (RBAC)
+4) Subscription and billing
+5) Dashboard and analytics
+6) API access
+7) Admin panel
+📊 CRM/Business Tool common features:
+1) User/team management
+2) Contact/customer database
+3) Activity tracking and logging
+4) Reporting and analytics
+5) Integrations (email, calendar, etc.)
+6) Search and filters
+7) Export functionality
+🎮 Social/Community common features:
+1) User profiles
+2) Posts/content creation
+3) Feed/timeline
+4) Comments and reactions
+5) Follow/friend system
+6) Notifications
+7) Moderation tools
+⭐ Your specific features (add any custom functionalities):
+-
+-
+-
+
+List all functionalities your system needs (select from above or add your own):
+```
 
-**If Native iOS:**
+**1.7 Scope Definition**
 
-- **CocoaPods** or **Swift Package Manager**
+```
+Now let's prioritize: What will you build in this first version, and what will you leave for future versions?
 
-**If Native Android:**
+This helps us focus the documentation on what you're building now, while noting what comes later.
 
-- **Gradle** (built-in)
+📋 What will you build in this first version? (Select from the features listed above)
 
-**Your answer:**
+[Show features from question 1.6 and allow selection]
 ---
-### Question 1.9: Build Tools & CI/CD
-
-**What build and deployment tools will you use?**
-
-A) ⭐ **Fastlane** (Recommended for iOS/Android)
-
-- Automates builds, screenshots, deployment
-- Works with React Native, Flutter, Native
-- Best for: Most projects
-
-B) **Codemagic**
-
-- Cloud-based CI/CD for Flutter/React Native
-- Easy setup, good for small teams
-
-C) **GitHub Actions**
-
-- Flexible, free for public repos
-- Custom workflows
+⏭️ What will you leave for future versions? (What you're NOT building now)
+
+Common things to defer:
+1) Mobile native apps (building web/API first)
+2) Advanced analytics/ML features
+3) Third-party integrations (v2)
+4) White-label/multi-branding
+5) Internationalization (i18n)
+6) Advanced automation/workflows
+7) Video/live streaming features
+⭐ Other features to defer (add your own):
+-
+-
+-
+
+💡 Tip: It's okay to start simple! You can always expand later. This helps us create focused documentation for your current needs.
+```
 
-D) **Bitrise**
+**1.8 Constraints**
 
-- Mobile-focused CI/CD
-- Good for complex workflows
+```
+What constraints does this project have? Select all that apply:
 
-E) **Manual Builds**
+A) ⏰ Time - Must launch by specific date
+B) 💰 Budget - Limited development resources
+C) 📜 Compliance - Regulatory requirements (GDPR, HIPAA, SOC2, etc.)
+D) 🔧 Technology - Must use specific tech stack
+E) 📊 Scale - Must handle specific traffic/data volume
+F) 🔐 Security - High security requirements
+G) ⚡ Performance - Strict latency/throughput requirements
 
-- Build locally, upload manually
-- Best for: Learning, small projects
+For each selected, provide details:
 
-**Your answer:**
----
-### Question 1.10: Code Signing Strategy
+Example:
+- Time: Must launch MVP by Q3 2024
+- Compliance: Must be GDPR compliant as we serve EU users
+```
 
-**How will you handle code signing?**
+**1.9 Success Metrics**
 
-**For iOS:**
+```
+How will you measure success?
 
-- A) ⭐ **Automatic Signing** (Recommended)
-  - Xcode manages certificates
-  - Easier for most developers
+1. Expected Users:
+   - Initial launch: __ users
+   - Year 1 goal: __ users
 
-- B) **Manual Signing**
-  - More control
-  - Required for enterprise apps
+2. Performance Targets:
+   - Response time: < __ ms
+   - Uptime: __ %
 
-**For Android:**
+3. Business Goals:
+   - [Goal 1]
+   - [Goal 2]
 
-- A) ⭐ **Automatic Signing** (Recommended)
-  - Gradle manages keystores
-  - Easier for most developers
+⭐ Standard for MVP:
+- Users: 1,000 initial / 10,000 Year 1
+- Response time: < 500ms (API), < 100ms (DB)
+- Uptime: 99.9% (Standard cloud SLA)
 
-- B) **Manual Signing**
-  - More control
-  - Required for some enterprise scenarios
+🏆 Standard for Production/Scale:
+- Users: 100,000+ active
+- Response time: < 200ms (API), < 50ms (DB)
+- Uptime: 99.99% (High Availability)
+```
 
-**Your answer:**
----
-### Question 1.11: App Store Accounts
+**1.10 Main Business Flows**
 
-**Do you have App Store accounts set up?**
+> Note: If you omit any common flow or functionality, the AI will suggest and document typical processes relevant to your system type, based on best practices and common use cases.
 
-**For iOS:**
+`````
+List the main business flows of the system (e.g., sales, inventory update, invoicing, user registration).
 
-- A) ✅ **Yes, Apple Developer Account** ($99/year)
-- B) ❌ **No, will set up later**
-- C) **Enterprise Account** ($299/year)
+For each flow, you can add a brief description (optional).
 
-**For Android:**
+If you wish, you can specify the main steps of any flow (numbered format). If you do not specify them, the AI will deduce typical steps based on the name and description.
 
-- A) ✅ **Yes, Google Play Developer Account** ($25 one-time)
-- B) ❌ **No, will set up later**
+Example:
+- Sales: Process of purchasing products by the customer.
+  1. Customer selects products
+  2. Order is created
+  3. Inventory is updated
+  4. Invoice is generated
+- Inventory: Automatic stock update after each sale.
+- Invoicing: Invoice generation after purchase.
 
-**Your answer:**
+The AI will automatically generate flow diagrams (mermaid) for each documented process.
 ---
-### Question 1.12: Beta Testing Strategy
-
-**How will you handle beta testing?**
-
-A) ⭐ **TestFlight (iOS) + Firebase App Distribution (Android)**
-
-- Free, easy to use
-- Best for: Most projects
-
-B) **TestFlight (iOS) + Google Play Internal Testing (Android)**
-
-- Official store channels
-- Best for: Store-focused testing
-
-C) **HockeyApp / App Center**
-
-- Microsoft's solution
-- Good for enterprise
-
-D) **No Beta Testing**
-
-- Direct to production
-- Best for: MVPs, internal apps
+#### 🎨 MERMAID BUSINESS FLOW DIAGRAM FORMAT - CRITICAL
+
+**Use this exact format** for business process flows:
+
+````markdown
+```mermaid
+flowchart TD
+    Start([User Visits Site]) --> Browse[Browse Product Catalog]
+    Browse --> Search{Search or<br/>Browse Categories?}
+
+    Search -->|Use Search| Filter[Apply Search Filters]
+    Search -->|Browse| Category[Select Category]
+
+    Filter --> Results[View Search Results]
+    Category --> Results
+
+    Results --> Select[Select Product]
+    Select --> Details[View Product Details]
+    Details --> Decision{Add to Cart?}
+
+    Decision -->|Yes| AddCart[Add Item to Cart]
+    Decision -->|No| Browse
+
+    AddCart --> MoreShopping{Continue<br/>Shopping?}
+    MoreShopping -->|Yes| Browse
+    MoreShopping -->|No| Cart[View Shopping Cart]
+
+    Cart --> ReviewCart{Cart OK?}
+    ReviewCart -->|Modify| Browse
+    ReviewCart -->|Proceed| Checkout[Start Checkout]
+
+    Checkout --> Address[Enter/Confirm Address]
+    Address --> Payment[Enter Payment Info]
+    Payment --> Review[Review Order]
+    Review --> ProcessPayment[Process Payment]
+
+    ProcessPayment --> PaymentResult{Payment<br/>Success?}
+
+    PaymentResult -->|Success| Confirm[Order Confirmation]
+    PaymentResult -->|Declined| Retry{Retry<br/>Payment?}
+
+    Retry -->|Yes| Payment
+    Retry -->|No| SaveCart[Save Cart for Later]
+    SaveCart --> End1([Exit: Saved])
+
+    Confirm --> Email[Send Confirmation Email]
+    Email --> Inventory[Update Inventory]
+    Inventory --> Invoice[Generate Invoice]
+    Invoice --> End2([Order Complete])
+
+    style Start fill:#e1f5ff
+    style End1 fill:#ffe1e1
+    style End2 fill:#e1ffe1
+    style ProcessPayment fill:#fff4e1
+    style Confirm fill:#d4edda
+`````
+
+````
+
+**Flowchart Syntax:**
+- `flowchart TD` = Top-Down flow (recommended)
+- `flowchart LR` = Left-Right flow
+- `flowchart BT` = Bottom-Top
+- `flowchart RL` = Right-Left
+
+**Node Shapes:**
+- `[Rectangle]` = Process step/action
+- `{Diamond}` = Decision point (Yes/No, multiple options)
+- `([Rounded Rectangle])` = Start/End terminal
+- `[(Cylinder)]` = Database operation
+- `[[Subroutine]]` = Sub-process
+- `[/Parallelogram/]` = Input/Output
+- `((Circle))` = Connection point
+
+**Arrow Types:**
+- `-->` = Solid arrow (standard flow)
+- `-.->` = Dotted arrow (optional/conditional)
+- `==>` = Thick arrow (emphasis)
+- `-->|Label|` = Labeled arrow (decision branch)
+
+**Best Practices for Business Flows:**
+1. **Always start with a terminal**: `([Start])`
+2. **Always end with a terminal**: `([End])`
+3. **Label decision branches**: Use `-->|Yes|` or `-->|No|`
+4. **Use line breaks in labels**: `{Continue<br/>Shopping?}` for readability
+5. **Apply consistent styling**: Same colors for similar node types
+6. **Keep it readable**: Avoid spaghetti flows, group related steps
+7. **Show all paths**: Every decision should have all branches defined
+8. **Include error paths**: Payment failures, validation errors, etc.
+
+**Multiple Flow Example (Advanced):**
+
+```mermaid
+flowchart TD
+    subgraph "Customer Journey"
+        C1[Browse] --> C2[Select]
+        C2 --> C3[Purchase]
+    end
+
+    subgraph "Backend Processing"
+        B1[Validate Order] --> B2[Process Payment]
+        B2 --> B3[Update Inventory]
+        B3 --> B4[Send Notifications]
+    end
+
+    C3 --> B1
+    B4 --> C4[Confirmation]
+```
 
-**Your answer:**
+**Color Coding Guide:**
+- Blue (`#e1f5ff`): Start/Entry points
+- Green (`#e1ffe1`): Success/Completion
+- Red (`#ffe1e1`): Failure/Error states
+- Yellow (`#fff4e1`): Critical operations (Payment, Auth)
+- Purple (`#f0e1ff`): External integrations
+
+**Common Business Flows to Document:**
+- User Registration/Login
+- Purchase/Checkout Process
+- Content Creation/Publishing
+- Approval/Review Workflows
+- Data Import/Export
+- Notification/Alert Flows
+- Customer Support Ticket Lifecycle
+
+**Validation:** Test at https://mermaid.live/ before saving
 ---
-### Question 1.13: Analytics & Crash Reporting
-
-**What analytics and crash reporting will you use?**
-
-A) ⭐ **Firebase Analytics + Crashlytics** (Recommended)
-
-- Free, comprehensive
-- Works with iOS and Android
-- Best for: Most projects
-
-B) **Sentry**
-
-- Excellent error tracking
-- Good for: Production apps
-
-C) **Mixpanel / Amplitude**
-
-- Advanced analytics
-- Best for: Product analytics focus
+```
 
-D) **No Analytics**
+### Phase 1 Output
 
-- Privacy-focused
-- Best for: Privacy-critical apps
+After gathering all information, confirm:
 
-**Your answer:**
+```
+📋 PHASE 1 SUMMARY:
+
+Project: [name]
+Description: [1 sentence]
+Users: [list]
+Objectives: [3 objectives]
+System Type: [E-commerce/SaaS/etc.]
+Core Features: [list of main functionalities]
+First Version Features: [what will be built now]
+Future Features: [what will be deferred]
+Constraints: [list with details]
+Success Metrics: [KPIs]
+Business Flows: [list of main flows]
+
+Is this correct? (Yes/No)
+If corrections needed, specify which section.
+```
 ---
-### Question 1.14: UI/UX Framework
-
-**What UI/UX framework or design system will you use?**
-
-**If React Native:**
-
-- A) ⭐ **React Native Paper** (Material Design)
-  - Material Design components
-  - Best for: Android-first apps
-- B) **React Native Elements**
-  - Cross-platform components
-  - Best for: Customizable UI
-- C) **NativeBase**
-  - Component library
-  - Best for: Rapid development
-- D) **Custom UI Components**
-  - Build your own components
-  - Best for: Brand-specific design
-
-**If Flutter:**
-
-- A) ⭐ **Material Design 3** (Default)
-  - Google's Material Design
-  - Best for: Most apps
-- B) **Cupertino Design**
-  - iOS-style components
-  - Best for: iOS-first apps
-- C) **Custom Theme**
-  - Custom design system
-  - Best for: Brand-specific design
+### 📄 Generate Phase 1 Documents
 
-**If Native iOS:**
+**Generate `project-brief.md` automatically:**
 
-- A) ⭐ **UIKit** (Standard)
-- B) **SwiftUI** (Modern)
+- Use template: `.ai-flow/templates/project-brief.template.md`
+- Fill with all Phase 1 information
+- Write to project root: `project-brief.md`
 
-**If Native Android:**
+```
+✅ Generated: project-brief.md
 
-- A) ⭐ **Material Design Components**
-- B) **Jetpack Compose**
+The document has been created with all the information from Phase 1.
 
-**Your answer:**
+📝 Would you like to make any corrections before continuing?
 
-**If cross-platform, ask:**
+→ If yes: Edit project-brief.md and type "ready" when done. I'll re-read it.
+→ If no: Type "continue" to proceed to Phase 2.
+```
 
-- Will you use platform-specific UI? (iOS uses Cupertino, Android uses Material)
-- Or unified design across platforms?
+**If user edits the file:**
+Execute `read_file('project-brief.md')` to refresh context before continuing.
 ---
-### Question 1.15: Theme & Dark Mode
-
-**Will your app support dark mode?**
-
-A) ⭐ **Yes - System Theme** (Recommended)
-
-- Follows system dark/light mode
-- Best for: Most apps
 
-B) **Yes - Manual Toggle**
-
-- User can toggle dark/light mode
-- Best for: Apps with theme customization
-
-C) **No Dark Mode**
+## 📝 Generated Documents
 
-- Light mode only
-- Best for: Simple apps
+After Phase 1, generate/update:
+- `project-brief.md` - Core project discovery and requirements
 
-**Your answer:**
 ---
-### Question 1.16: Internationalization (i18n)
 
-**Will your app support multiple languages?**
+**Next Phase:** Phase 2 - Data Architecture (15-20 min)
 
-A) ⭐ **Yes - Multiple Languages** (Recommended)
+Read: `.ai-flow/prompts/backend/flow-build-phase-2.md`
 
-- Support 2+ languages
-- Best for: Global apps
-
-B) **Yes - English Only (for now)**
-
-- Single language, but i18n-ready
-- Best for: MVPs planning expansion
-
-C) **No Internationalization**
-
-- Single language only
-- Best for: Local apps
-
-**Your answer:**
-
-**If multiple languages selected, ask:**
-
-- What i18n library?
-  - React Native: react-i18next, react-native-localize
-  - Flutter: intl, easy_localization
-  - Native: NSLocalizedString (iOS), Resources (Android)
 ---
-### Question 1.17: Image & Asset Management
-
-**How will you handle images and assets?**
 
-A) ⭐ **Local Assets + Remote Images** (Recommended)
+**Last Updated:** 2025-12-20
+**Version:** 2.1.8
 
-- Local assets for icons/logos
-- Remote images for content
-- Best for: Most apps
-
-B) **All Local Assets**
-
-- All images bundled with app
-- Best for: Small apps, offline-first
-
-C) **All Remote Images**
-
-- All images from CDN/server
-- Best for: Content-heavy apps
-
-**Your answer:**
-
-**If remote images selected, ask:**
-
-- What image optimization library?
-  - 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 2: Data Architecture (15-20 min)
 
-```
----
-✅ Phase 1 Complete: Platform & Framework Selection
----
-Project Name: [Answer from 1.1]
-Project Description: [Answer from 1.1]
-Selected Stack:
-- 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 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-12-XX
 
-**Version:** 1.5.0