ai-flow-dev 2.7.0 → 2.8.0

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

@@ -1,888 +1,888 @@
-# 🏆 Phase 8: Project Setup & Final Documentation
-
-**Context:** Phases 1-7 have collected all project information. Now we'll initialize the framework (if needed) and generate all final documentation.
-
-**Duration:** 10-15 minutes
-
-**Goal:** Set up the project structure and create comprehensive documentation that consolidates all information from previous phases.
----
-## 📋 Phase 8 Overview
-
-This final phase will:
-
-1. **Detect project state** (new vs existing project)
-2. **Initialize framework** (optional, for new projects)
-3. **Generate final documentation** (platform guides, deployment, app store)
-4. **Generate master index** (AGENT.md)
-5. **Generate README.md** (with intelligent merge if needed)
-6. **Create tool-specific configs** (based on AI tool selection)
----
-// turbo
-## 8.1: Project State Detection
-
-```
-🔍 Detecting current project state...
-
-**⚠️ CRITICAL: Ignore AI Flow documentation and Meta files during detection:**
-- Files: project-brief.md, ai-instructions.md, AGENT.md, .env.example, .cursorrules, .clauderules, .geminirules
-- Directories: .ai-flow/, .agent/, docs/, specs/
-```
-
-**Auto-detect:**
-
-- [ ] Check for existing source code (`src/`, `app/`, `ios/`, `android/`, `lib/`, etc.)
-- [ ] Check for framework files (`package.json`, `pubspec.yaml`, `Podfile`, `build.gradle`, etc.)
-- [ ] Check for platform directories (`ios/`, `android/`, `lib/` for Flutter)
-- [ ] Check for existing README.md (framework-generated or custom)
-
-**Classification:**
-
-- **New Project**: No source code, no framework files
-- **Initialized Framework**: Has framework files, has source code
-- **Existing Project**: Has source code but AI Flow docs were just created
-
-**Present Detection Results:**
-
-```
-📊 Project State Detection:
-
-Type: [New Project | Initialized Framework | Existing Project]
-
-Found:
-- Source directories: [list or none]
-- Framework files: [list or none]
-- Platform directories: [ios/, android/, or none]
-- Package manager: [npm/yarn/flutter/etc. or none]
-- README.md: [exists: yes/no]
-
-Recommendation: [Next action based on state]
-```
----
-## 8.2: Framework Initialization (Optional)
-
-**Only if:** Project state = "New Project"
-
-### 8.2.1: Ask User Preference
-
-```
-🎯 Your project appears to be new.
-
-Would you like me to initialize the [FRAMEWORK_NAME] project structure now?
-
-Options:
-A) ✅ Yes, initialize [FRAMEWORK_NAME] (recommended)
-B) ⏭️  Skip for now (manual setup later)
-
-→ Your choice:
-```
-
-**If user chooses A (initialize):**
-
-### 8.2.2: Pre-initialization Backup
-
-```
-📦 Preparing for framework initialization...
-
-Creating backup of AI Flow documentation:
-→ Moving .ai-flow/ docs to .ai-flow/temp-backup/
-
-Files to backup:
-✅ project-brief.md
-✅ docs/app-structure.md
-✅ docs/architecture.md
-✅ ai-instructions.md
-✅ docs/code-standards.md
-✅ docs/testing.md
-✅ docs/app-store.md
-✅ specs/build-configuration.md
-✅ specs/deployment.md
-✅ .env.example
-
-Backup complete! Safe to initialize framework.
-```
-
-### 8.2.3: Execute Framework CLI
-
-**Based on framework detected in Phase 1:**
-
-**React Native:**
-
-```bash
-# React Native CLI
-npx react-native@latest init ProjectName --skip-git
-
-# Expo (managed workflow)
-npx create-expo-app@latest . --template blank-typescript
-
-# Expo (bare workflow)
-npx create-expo-app@latest . --template bare-typescript
-```
-
-**Flutter:**
-
-```bash
-# Flutter CLI
-flutter create . --org com.yourcompany --platforms ios,android
-
-# Flutter with specific template
-flutter create . --template app --org com.yourcompany
-```
-
-**Native iOS:**
-
-```bash
-# SwiftUI app
-xcodegen generate
-# Or manually create Xcode project
-```
-
-**Native Android:**
-
-```bash
-# Android Studio template
-# Create manually through Android Studio or use Gradle
-```
-
-**Other cross-platform:**
-
-```bash
-# Ionic
-ionic start . blank --type=angular --capacitor
-
-# Capacitor
-npm init @capacitor/app
-
-# NativeScript
-ns create . --template @nativescript/template-blank-ts
-
-# Kotlin Multiplatform Mobile
-# Create through IntelliJ IDEA or Android Studio
-```
-
-**Show progress:**
-
-```
-🚀 Initializing [FRAMEWORK_NAME]...
-
-[Framework CLI output]
-
-✅ Framework initialized successfully!
-```
-
-### 8.2.4: Restore AI Flow Documentation
-
-```
-📥 Restoring AI Flow documentation...
-
-Moving files from .ai-flow/temp-backup/ back to .ai-flow/
-
-✅ All AI Flow docs restored!
-```
-
-### 8.2.5: Handle README.md Conflict
-
-**If framework created README.md:**
-
-```
-⚠️  Framework generated its own README.md
-
-I'll merge it with AI Flow's comprehensive README:
-
-Strategy:
-1. Keep framework's quick start section (if valuable)
-2. Replace with AI Flow's comprehensive content
-3. Preserve any framework-specific setup instructions
-
-Merging...
-```
-
-**Merge Logic:**
-
-- Extract framework's "Getting Started" or "Installation" section
-- Use AI Flow's README template as base
-- Insert framework's quick start in appropriate section
-- Ensure no duplication
-- Keep AI Flow's structure (overview, features, tech stack, etc.)
-
-**If user chooses B (skip):**
-
-```
-⏭️  Skipping framework initialization.
-
-You can initialize manually later with:
-[Show appropriate CLI command]
-
-Proceeding to documentation generation...
-```
----
-## 8.3: Generate Final Documentation
-
-```
-📖 Re-reading all generated documents to ensure accuracy...
-
-✅ Re-reading project-brief.md
-✅ Re-reading docs/app-structure.md
-✅ Re-reading docs/architecture.md
-✅ Re-reading ai-instructions.md
-✅ Re-reading docs/code-standards.md
-✅ Re-reading docs/testing.md
-✅ Re-reading docs/app-store.md
-✅ Re-reading specs/build-configuration.md
-✅ Re-reading specs/deployment.md
-✅ Re-reading .env.example
-
-✅ Context fully loaded and updated!
-
-🎉 Now generating final 5 documents:
-
-1. docs/platform-guides.md - iOS and Android specific implementations
-2. docs/navigation-guide.md - Navigation patterns and screen flow
-3. docs/contributing.md - Contribution guidelines
-4. .gitignore - Ignore patterns for React Native/Flutter
-5. AGENT.md - Universal AI configuration (master index)
-6. README.md - Project overview (consolidates all phases)
-
-Generating...
-```
-
-### 8.3.1: Generate docs/platform-guides.md
-
-- **Template:** `.ai-flow/templates/docs/platform-guides.template.md`
-- **Content from:** Phase 2 (app structure) + Phase 4 (platform permissions)
-- **Requirements:**
-  - iOS-specific implementations
-  - Android-specific implementations
-  - Platform-specific APIs usage
-  - Native module integration (if any)
-  - Platform permissions setup
-
-**📝 Action:** Write the complete file to `docs/platform-guides.md`
-
-```
-✅ Generated: docs/platform-guides.md
-```
-
-### 8.3.2: Generate docs/navigation-guide.md
-
-- **Template:** `.ai-flow/templates/docs/navigation-guide.template.md`
-- **Content from:** Phase 2 (navigation) + Phase 3 (architecture)
-- **Requirements:**
-  - Navigation strategy (stack, tabs, drawer)
-  - Screen hierarchy
-  - Deep linking setup
-  - Navigation parameters
-  - Authentication flow
-
-**📝 Action:** Write the complete file to `docs/navigation-guide.md`
-
-```
-✅ Generated: docs/navigation-guide.md
-```
-
-### 8.3.3: Generate docs/contributing.md
-
-- **Template:** `.ai-flow/templates/docs/contributing.template.md`
-- **Content from:** Phase 5 (code standards) + Phase 7 (deployment)
-- **Requirements:**
-  - Git workflow from Phase 5
-  - Commit message format
-  - Code review process
-  - Setup instructions
-  - Testing requirements from Phase 6
-  - Build and release process
-
-**📝 Action:** Write the complete file to `docs/contributing.md`
-
-```
-✅ Generated: docs/contributing.md
-```
----
-## 8.3.4: Generate .gitignore
-
-**IMPORTANT:** Generate a comprehensive `.gitignore` file based on the mobile framework selected in previous phases.
-
-```
-📝 Generating .gitignore for your mobile stack...
-```
-
-**Strategy:**
-
-1. **Detect framework from Phase 3** (React Native, Flutter, etc.)
-2. **Detect package manager** (npm, yarn, pub)
-3. **Combine relevant patterns**
-
-**React Native patterns:**
-
-```gitignore
-# React Native
-node_modules/
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-
-# Metro bundler
-.metro-health-check*
-
-# OSX
-.DS_Store
-
-# Android
-android/app/build/
-android/app/release/
-android/.gradle/
-android/local.properties
-android/.idea/
-android/*.iml
-android/app/debug/
-android/app/profile/
-android/keystore.properties
-android/key.properties
-
-# iOS
-ios/Pods/
-ios/**/*.mode1v3
-ios/**/*.mode2v3
-ios/**/*.perspectivev3
-ios/**/*.pbxuser
-ios/**/*.xcworkspace/xcuserdata
-ios/**/.DS_Store
-ios/build/
-ios/.xcode.env.local
-DerivedData/
-
-# Expo
-.expo/
-.expo-shared/
-web-build/
-dist/
-
-# Testing
-coverage/
-.nyc_output/
-
-# Environment
-.env
-.env*.local
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-
-# Logs
-logs/
-*.log
-```
-
-**Flutter patterns:**
-
-```gitignore
-# Flutter
-.dart_tool/
-.flutter-plugins
-.flutter-plugins-dependencies
-.packages
-.pub-cache/
-.pub/
-build/
-flutter_*.png
-linked_*.ds
-unlinked.ds
-unlinked_spec.ds
-
-# Android
-android/app/debug/
-android/app/profile/
-android/app/release/
-android/.gradle/
-android/local.properties
-android/gradle/
-android/gradlew
-android/gradlew.bat
-android/key.properties
-
-# iOS
-ios/Flutter/.last_build_id
-ios/Flutter/flutter_export_environment.sh
-ios/Pods/
-ios/**/*.mode1v3
-ios/**/*.mode2v3
-ios/**/*.pbxuser
-ios/**/*.perspectivev3
-ios/**/*.xcworkspace/xcuserdata
-ios/Runner.xcworkspace/
-
-# Web
-web/packages/
-
-# macOS
-macos/Flutter/
-
-# Testing
-coverage/
-.test_coverage.dart
-
-# Environment
-.env
-.env*.local
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-*.iml
-
-# OS
-.DS_Store
-Thumbs.db
-```
-
-**📝 Action:** Generate and write `.gitignore` to project root.
-
-**Selection logic:**
-
-- If React Native → Use React Native patterns
-- If Flutter → Use Flutter patterns
-- If Expo detected → Add Expo-specific patterns
-
-```
-✅ Generated: .gitignore
-   Patterns included: [React Native | Flutter] + Platform-specific
-```
----
-## 8.4: Generate AGENT.md (Master Index)
-
-- **Template:** `.ai-flow/templates/AGENT.template.md`
-- **Content from:** ALL phases (this is the aggregator)
-- **Requirements:**
-  - **CRITICAL:** Re-read ALL previously generated documents before filling
-  - List all documents with descriptions
-  - Provide quick reference to tech stack
-  - Include critical architecture rules
-  - Link to all specs and docs
-  - Summarize key decisions from each phase
-  - Include common commands
-
-**Structure:**
-
-```markdown
-# 🤖 AGENT.md - Universal AI Assistant Configuration
-
-## 📚 Documentation Index
-
-### Core Documents
-
-1. **project-brief.md** - [1-sentence description]
-2. **ai-instructions.md** - [1-sentence description]
-
-### Documentation
-
-3. **docs/app-structure.md** - [1-sentence description]
-4. **docs/architecture.md** - [1-sentence description]
-5. **docs/platform-guides.md** - [1-sentence description]
-6. **docs/navigation-guide.md** - [1-sentence description]
-7. **docs/code-standards.md** - [1-sentence description]
-8. **docs/testing.md** - [1-sentence description]
-9. **docs/app-store.md** - [1-sentence description]
-10. **docs/contributing.md** - [1-sentence description]
-
-### Specifications
-
-11. **specs/build-configuration.md** - [1-sentence description]
-12. **specs/deployment.md** - [1-sentence description]
-13. **.env.example** - Environment variables template
-14. **README.md** - Project overview and setup
-
-## 🎯 Quick Reference
-
-### Tech Stack
-
-[List from Phase 1 & 3]
-
-### Critical Rules
-
-[Key rules from code-standards.md and ai-instructions.md]
-
-### Common Commands
-
-[From deployment.md and contributing.md]
-```
-
-**📝 Action:**
-
-```
-🔄 Re-reading all generated documents for AGENT.md generation...
-
-✅ Reading .ai-flow/project-brief.md
-✅ Reading .ai-flow/ai-instructions.md
-✅ Reading docs/app-structure.md
-✅ Reading docs/architecture.md
-✅ Reading docs/platform-guides.md
-✅ Reading docs/navigation-guide.md
-✅ Reading docs/code-standards.md
-✅ Reading docs/testing.md
-✅ Reading docs/app-store.md
-✅ Reading specs/build-configuration.md
-✅ Reading specs/deployment.md
-✅ Reading docs/contributing.md
-
-✅ All context loaded!
-```
-
-**📝 Action:** Write the complete file to `.ai-flow/AGENT.md`
-
-```
-✅ Generated: .ai-flow/AGENT.md (Master Index)
-```
----
-## 8.5: Generate README.md (Intelligent Merge)
-
-- **Template:** `.ai-flow/templates/README.template.md`
-- **Content from:** ALL phases (most comprehensive document)
-- **Requirements:**
-  - **CRITICAL:** Re-read ALL documents before generating
-  - Include project overview from Phase 1
-  - List features from Phase 1
-  - Show tech stack from Phase 1 & 3
-  - Include quick start from Phase 7
-  - Link to all documentation
-  - Include deployment info from Phase 7
-  - Add app store links placeholders
-
-**Merge Strategy (if framework README exists):**
-
-1. **Read framework's README.md** (if exists from step 8.2)
-2. **Extract valuable sections:**
-   - Installation commands specific to framework
-   - Framework-specific setup instructions
-   - Running on iOS/Android commands
-   - Troubleshooting tips
-3. **Use AI Flow template as base structure:**
-   - Project name and description (from Phase 1)
-   - Features (from Phase 1)
-   - Tech stack (from Phase 1 & 3)
-   - Architecture overview (link to docs/architecture.md)
-   - Getting started (merge with framework's instructions)
-   - Platform setup (iOS/Android requirements)
-   - Testing (link to docs/testing.md)
-   - Deployment (from Phase 7)
-   - Contributing (link to docs/contributing.md)
-4. **Insert framework-specific content** in "Getting Started" section
-5. **Ensure no duplication**
-6. **Validate all links** work correctly
-
-**📝 Action:** Write the complete file to `.ai-flow/README.md`
-
-```
-✅ Generated: .ai-flow/README.md
-   [If merged] Merged with framework's setup instructions
-```
----
-## 8.6: Create Tool-Specific Configs
-
-**Based on AI tool selection from Phase 1:**
-
-### If Claude selected:
-
-**Create `.clauderules`:**
-
-```markdown
-# Claude AI Configuration
-
-This project uses AI Flow documentation structure.
-
-## Primary Reference
-
-Read `.ai-flow/AGENT.md` first for complete documentation index.
-
-## Key Documents
-
-- Project overview: `.ai-flow/project-brief.md`
-- AI instructions: `.ai-flow/ai-instructions.md`
-- Architecture: `docs/architecture.md`
-- App Structure: `docs/app-structure.md`
-- Platform Guides: `docs/platform-guides.md`
-- Navigation: `docs/navigation-guide.md`
-- Code standards: `docs/code-standards.md`
-
-## Working Instructions
-
-When writing code:
-
-1. Follow patterns in `docs/code-standards.md`
-2. Reference app structure in `docs/app-structure.md`
-3. Follow platform guidelines from `docs/platform-guides.md`
-4. Implement navigation per `docs/navigation-guide.md`
-5. Write tests per `docs/testing.md`
-
-## Critical Rules
-
-[Extract top 5-10 rules from ai-instructions.md]
-```
-
-### If Cursor selected:
-
-**Create `.cursorrules`:**
-
-```markdown
-# Cursor AI Configuration
-
-Project uses AI Flow documentation in `.ai-flow/` directory.
-
-## Documentation Index
-
-See `.ai-flow/AGENT.md` for complete document list.
-
-## Quick Reference
-
-- Tech Stack: [from Phase 1 & 3]
-- Architecture: `docs/architecture.md`
-- Platform Guides: `docs/platform-guides.md`
-- Code Standards: `docs/code-standards.md`
-
-## Code Generation Rules
-
-[Extract key rules from ai-instructions.md]
-```
-
-### If GitHub Copilot selected:
-
-**Create `.github/copilot-instructions.md`:**
-
-```markdown
-# GitHub Copilot Instructions
-
-## Project Context
-
-[Project description from Phase 1]
-
-## Documentation Structure
-
-This project uses AI Flow. All documentation is in `.ai-flow/` directory.
-
-Master index: `.ai-flow/AGENT.md`
-
-## Key References
-
-- Architecture: `docs/architecture.md`
-- App Structure: `docs/app-structure.md`
-- Platform Guides: `docs/platform-guides.md`
-- Navigation: `docs/navigation-guide.md`
-- Code Standards: `docs/code-standards.md`
-- Testing: `docs/testing.md`
-
-## Code Generation Guidelines
-
-[Extract guidelines from ai-instructions.md and code-standards.md]
-
-## Tech Stack
-
-[From Phase 1 & 3]
-```
-
-**📝 Action:** Generate the tool-specific config files based on selection:
-
-- 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]
-```
----
-## 8.7: Final Validation & Success Message
-
-```
-🔍 Validating all generated files...
-
-✅ Checking for placeholder text...
-✅ Validating file references...
-✅ Ensuring all links work...
-✅ Verifying template completeness...
-
-All validations passed!
-```
-
-**Show complete summary:**
-
-```
-🎉 AI Flow Complete!
-
-Generated 15 documents successfully:
-
-Phase 1:
-✅ project-brief.md
-
-Phase 2:
-✅ docs/app-structure.md
-
-Phase 3:
-✅ docs/architecture.md
-✅ ai-instructions.md
-
-Phase 5:
-✅ docs/code-standards.md
-
-Phase 6:
-✅ docs/testing.md
-
-Phase 7:
-✅ docs/app-store.md
-✅ specs/build-configuration.md
-✅ specs/deployment.md
-✅ .env.example
-
-Phase 8:
-✅ docs/platform-guides.md
-✅ docs/navigation-guide.md
-✅ docs/contributing.md
-✅ .gitignore
-✅ README.md
-✅ AGENT.md
-
-[If framework initialized:]
-✅ [FRAMEWORK_NAME] project initialized
-
-[If README merged:]
-✅ README.md merged with framework's setup instructions
-
-Tool-specific configs:
-✅ [List generated configs]
----
-📁 Project Structure:
-
-your-app/
-├── .ai-flow/                    # AI Flow documentation
-│   ├── AGENT.md                 ⭐ Start here!
-│   ├── project-brief.md
-│   ├── ai-instructions.md
-│   ├── docs/
-│   │   ├── app-structure.md
-│   │   ├── architecture.md
-│   │   ├── platform-guides.md
-│   │   ├── navigation-guide.md
-│   │   ├── code-standards.md
-│   │   ├── testing.md
-│   │   ├── app-store.md
-│   │   └── contributing.md
-│   ├── specs/
-│   │   ├── build-configuration.md
-│   │   └── deployment.md
-│   └── templates/               # Original templates
-├── ios/                         # iOS platform (if initialized)
-├── android/                     # Android platform (if initialized)
-├── src/ or lib/                 # Source code (if initialized)
-├── README.md
-├── .env.example
-├── .gitignore
-└── [tool configs]               # .clauderules, .cursorrules, etc.
----
-Next steps:
-
-1. ⭐ **Read `.ai-flow/AGENT.md`** - Master index of all documentation
-2. 📖 **Review generated documents** - Customize as needed
-3. 🔧 **Set up environment** - Copy `.env.example` to `.env` and configure
-[If NOT initialized:]
-4. 🚀 **Initialize framework** - Run: `[show command from Phase 1]`
-[If initialized:]
-4. 🚀 **Install dependencies** - Run platform-specific setup:
-   • React Native: `npm install && cd ios && pod install`
-   • Flutter: `flutter pub get`
-   • Expo: `npm install`
-5. 📱 **Run on device/simulator**:
-   • iOS: `npm run ios` or `flutter run`
-   • Android: `npm run android` or `flutter run`
-6. 💾 **Initialize git** (if not done) - `git init && git add . && git commit -m "Initial commit with AI Flow docs"`
-7. 🧪 **Start developing!** - Your AI assistant now has complete project context
----
-💡 **Remember:**
-- Documents are **living artifacts** - update them as project evolves
-- All AI assistants will reference these docs for future work
-- AGENT.md is the **single source of truth** for AI context
-
-🤖 **AI Assistant Usage:**
-Your AI assistant (Claude, Cursor, Copilot) will now:
-- ✅ Understand complete project context
-- ✅ Follow your architecture patterns
-- ✅ Generate code matching your standards
-- ✅ Reference your app structure
-- ✅ Apply platform-specific best practices
-- ✅ Write tests per your guidelines
-
-Happy building! 🎉📱
-```
----
-## EXECUTION CHECKLIST FOR AI ASSISTANT
-
-When executing Phase 8:
-
-**8.1 Project State Detection:**
-
-- [ ] Scan for source directories (src/, lib/, app/)
-- [ ] Check for platform directories (ios/, android/)
-- [ ] Check for framework files (package.json, pubspec.yaml, etc.)
-- [ ] Check for existing README.md
-- [ ] Classify project: New / Initialized / Existing
-- [ ] Present detection results
-
-**8.2 Framework Initialization (if new project):**
-
-- [ ] Ask user if they want to initialize
-- [ ] If yes:
-  - [ ] Backup .ai-flow/ docs
-  - [ ] Execute framework CLI command
-  - [ ] Restore .ai-flow/ docs
-  - [ ] Handle README.md conflict
-- [ ] If no: Show manual command and continue
-
-**8.3 Generate Final Documentation:**
-
-- [ ] Re-read ALL previously generated documents
-- [ ] Generate docs/platform-guides.md
-- [ ] Generate docs/navigation-guide.md
-- [ ] Generate docs/contributing.md
-
-**8.4 Generate AGENT.md:**
-
-- [ ] Re-read ALL documents again
-- [ ] Create master index
-- [ ] Include quick reference
-- [ ] Validate all links
-
-**8.5 Generate README.md:**
-
-- [ ] Re-read ALL documents
-- [ ] If framework README exists: merge intelligently
-- [ ] If no framework README: create from template
-- [ ] Validate all internal links
-
-**8.6 Create Tool-Specific Configs:**
-
-- [ ] Create configs based on AI tool selection
-
-**8.7 Final Validation:**
-
-- [ ] Check for placeholders
-- [ ] Validate file references
-- [ ] Show success message
-
-**ESTIMATED TIME:** 10-15 minutes
----
-**Next Phase:** Phase 9 - Project Roadmap (Post-Documentation)
-
-Read: `.ai-flow/prompts/mobile/flow-build-phase-9.md`
-
----
-
-**Last Updated:** 2025-12-21
-**Version:** 2.1.9
-
-
-
-
+# 🏆 Phase 8: Project Setup & Final Documentation
+
+**Context:** Phases 1-7 have collected all project information. Now we'll initialize the framework (if needed) and generate all final documentation.
+
+**Duration:** 10-15 minutes
+
+**Goal:** Set up the project structure and create comprehensive documentation that consolidates all information from previous phases.
+---
+## 📋 Phase 8 Overview
+
+This final phase will:
+
+1. **Detect project state** (new vs existing project)
+2. **Initialize framework** (optional, for new projects)
+3. **Generate final documentation** (platform guides, deployment, app store)
+4. **Generate master index** (AGENT.md)
+5. **Generate README.md** (with intelligent merge if needed)
+6. **Create tool-specific configs** (based on AI tool selection)
+---
+// turbo
+## 8.1: Project State Detection
+
+```
+🔍 Detecting current project state...
+
+**⚠️ CRITICAL: Ignore AI Flow documentation and Meta files during detection:**
+- Files: project-brief.md, ai-instructions.md, AGENT.md, .env.example, .cursorrules, .clauderules, .geminirules
+- Directories: .ai-flow/, .agent/, docs/, specs/
+```
+
+**Auto-detect:**
+
+- [ ] Check for existing source code (`src/`, `app/`, `ios/`, `android/`, `lib/`, etc.)
+- [ ] Check for framework files (`package.json`, `pubspec.yaml`, `Podfile`, `build.gradle`, etc.)
+- [ ] Check for platform directories (`ios/`, `android/`, `lib/` for Flutter)
+- [ ] Check for existing README.md (framework-generated or custom)
+
+**Classification:**
+
+- **New Project**: No source code, no framework files
+- **Initialized Framework**: Has framework files, has source code
+- **Existing Project**: Has source code but AI Flow docs were just created
+
+**Present Detection Results:**
+
+```
+📊 Project State Detection:
+
+Type: [New Project | Initialized Framework | Existing Project]
+
+Found:
+- Source directories: [list or none]
+- Framework files: [list or none]
+- Platform directories: [ios/, android/, or none]
+- Package manager: [npm/yarn/flutter/etc. or none]
+- README.md: [exists: yes/no]
+
+Recommendation: [Next action based on state]
+```
+---
+## 8.2: Framework Initialization (Optional)
+
+**Only if:** Project state = "New Project"
+
+### 8.2.1: Ask User Preference
+
+```
+🎯 Your project appears to be new.
+
+Would you like me to initialize the [FRAMEWORK_NAME] project structure now?
+
+Options:
+A) ✅ Yes, initialize [FRAMEWORK_NAME] (recommended)
+B) ⏭️  Skip for now (manual setup later)
+
+→ Your choice:
+```
+
+**If user chooses A (initialize):**
+
+### 8.2.2: Pre-initialization Backup
+
+```
+📦 Preparing for framework initialization...
+
+Creating backup of AI Flow documentation:
+→ Moving .ai-flow/ docs to .ai-flow/temp-backup/
+
+Files to backup:
+✅ project-brief.md
+✅ docs/app-structure.md
+✅ docs/architecture.md
+✅ ai-instructions.md
+✅ docs/code-standards.md
+✅ docs/testing.md
+✅ docs/app-store.md
+✅ specs/build-configuration.md
+✅ specs/deployment.md
+✅ .env.example
+
+Backup complete! Safe to initialize framework.
+```
+
+### 8.2.3: Execute Framework CLI
+
+**Based on framework detected in Phase 1:**
+
+**React Native:**
+
+```bash
+# React Native CLI
+npx react-native@latest init ProjectName --skip-git
+
+# Expo (managed workflow)
+npx create-expo-app@latest . --template blank-typescript
+
+# Expo (bare workflow)
+npx create-expo-app@latest . --template bare-typescript
+```
+
+**Flutter:**
+
+```bash
+# Flutter CLI
+flutter create . --org com.yourcompany --platforms ios,android
+
+# Flutter with specific template
+flutter create . --template app --org com.yourcompany
+```
+
+**Native iOS:**
+
+```bash
+# SwiftUI app
+xcodegen generate
+# Or manually create Xcode project
+```
+
+**Native Android:**
+
+```bash
+# Android Studio template
+# Create manually through Android Studio or use Gradle
+```
+
+**Other cross-platform:**
+
+```bash
+# Ionic
+ionic start . blank --type=angular --capacitor
+
+# Capacitor
+npm init @capacitor/app
+
+# NativeScript
+ns create . --template @nativescript/template-blank-ts
+
+# Kotlin Multiplatform Mobile
+# Create through IntelliJ IDEA or Android Studio
+```
+
+**Show progress:**
+
+```
+🚀 Initializing [FRAMEWORK_NAME]...
+
+[Framework CLI output]
+
+✅ Framework initialized successfully!
+```
+
+### 8.2.4: Restore AI Flow Documentation
+
+```
+📥 Restoring AI Flow documentation...
+
+Moving files from .ai-flow/temp-backup/ back to .ai-flow/
+
+✅ All AI Flow docs restored!
+```
+
+### 8.2.5: Handle README.md Conflict
+
+**If framework created README.md:**
+
+```
+⚠️  Framework generated its own README.md
+
+I'll merge it with AI Flow's comprehensive README:
+
+Strategy:
+1. Keep framework's quick start section (if valuable)
+2. Replace with AI Flow's comprehensive content
+3. Preserve any framework-specific setup instructions
+
+Merging...
+```
+
+**Merge Logic:**
+
+- Extract framework's "Getting Started" or "Installation" section
+- Use AI Flow's README template as base
+- Insert framework's quick start in appropriate section
+- Ensure no duplication
+- Keep AI Flow's structure (overview, features, tech stack, etc.)
+
+**If user chooses B (skip):**
+
+```
+⏭️  Skipping framework initialization.
+
+You can initialize manually later with:
+[Show appropriate CLI command]
+
+Proceeding to documentation generation...
+```
+---
+## 8.3: Generate Final Documentation
+
+```
+📖 Re-reading all generated documents to ensure accuracy...
+
+✅ Re-reading project-brief.md
+✅ Re-reading docs/app-structure.md
+✅ Re-reading docs/architecture.md
+✅ Re-reading ai-instructions.md
+✅ Re-reading docs/code-standards.md
+✅ Re-reading docs/testing.md
+✅ Re-reading docs/app-store.md
+✅ Re-reading specs/build-configuration.md
+✅ Re-reading specs/deployment.md
+✅ Re-reading .env.example
+
+✅ Context fully loaded and updated!
+
+🎉 Now generating final 5 documents:
+
+1. docs/platform-guides.md - iOS and Android specific implementations
+2. docs/navigation-guide.md - Navigation patterns and screen flow
+3. docs/contributing.md - Contribution guidelines
+4. .gitignore - Ignore patterns for React Native/Flutter
+5. AGENT.md - Universal AI configuration (master index)
+6. README.md - Project overview (consolidates all phases)
+
+Generating...
+```
+
+### 8.3.1: Generate docs/platform-guides.md
+
+- **Template:** `.ai-flow/templates/docs/platform-guides.template.md`
+- **Content from:** Phase 2 (app structure) + Phase 4 (platform permissions)
+- **Requirements:**
+  - iOS-specific implementations
+  - Android-specific implementations
+  - Platform-specific APIs usage
+  - Native module integration (if any)
+  - Platform permissions setup
+
+**📝 Action:** Write the complete file to `docs/platform-guides.md`
+
+```
+✅ Generated: docs/platform-guides.md
+```
+
+### 8.3.2: Generate docs/navigation-guide.md
+
+- **Template:** `.ai-flow/templates/docs/navigation-guide.template.md`
+- **Content from:** Phase 2 (navigation) + Phase 3 (architecture)
+- **Requirements:**
+  - Navigation strategy (stack, tabs, drawer)
+  - Screen hierarchy
+  - Deep linking setup
+  - Navigation parameters
+  - Authentication flow
+
+**📝 Action:** Write the complete file to `docs/navigation-guide.md`
+
+```
+✅ Generated: docs/navigation-guide.md
+```
+
+### 8.3.3: Generate docs/contributing.md
+
+- **Template:** `.ai-flow/templates/docs/contributing.template.md`
+- **Content from:** Phase 5 (code standards) + Phase 7 (deployment)
+- **Requirements:**
+  - Git workflow from Phase 5
+  - Commit message format
+  - Code review process
+  - Setup instructions
+  - Testing requirements from Phase 6
+  - Build and release process
+
+**📝 Action:** Write the complete file to `docs/contributing.md`
+
+```
+✅ Generated: docs/contributing.md
+```
+---
+## 8.3.4: Generate .gitignore
+
+**IMPORTANT:** Generate a comprehensive `.gitignore` file based on the mobile framework selected in previous phases.
+
+```
+📝 Generating .gitignore for your mobile stack...
+```
+
+**Strategy:**
+
+1. **Detect framework from Phase 3** (React Native, Flutter, etc.)
+2. **Detect package manager** (npm, yarn, pub)
+3. **Combine relevant patterns**
+
+**React Native patterns:**
+
+```gitignore
+# React Native
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# Metro bundler
+.metro-health-check*
+
+# OSX
+.DS_Store
+
+# Android
+android/app/build/
+android/app/release/
+android/.gradle/
+android/local.properties
+android/.idea/
+android/*.iml
+android/app/debug/
+android/app/profile/
+android/keystore.properties
+android/key.properties
+
+# iOS
+ios/Pods/
+ios/**/*.mode1v3
+ios/**/*.mode2v3
+ios/**/*.perspectivev3
+ios/**/*.pbxuser
+ios/**/*.xcworkspace/xcuserdata
+ios/**/.DS_Store
+ios/build/
+ios/.xcode.env.local
+DerivedData/
+
+# Expo
+.expo/
+.expo-shared/
+web-build/
+dist/
+
+# Testing
+coverage/
+.nyc_output/
+
+# Environment
+.env
+.env*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Logs
+logs/
+*.log
+```
+
+**Flutter patterns:**
+
+```gitignore
+# Flutter
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+.pub-cache/
+.pub/
+build/
+flutter_*.png
+linked_*.ds
+unlinked.ds
+unlinked_spec.ds
+
+# Android
+android/app/debug/
+android/app/profile/
+android/app/release/
+android/.gradle/
+android/local.properties
+android/gradle/
+android/gradlew
+android/gradlew.bat
+android/key.properties
+
+# iOS
+ios/Flutter/.last_build_id
+ios/Flutter/flutter_export_environment.sh
+ios/Pods/
+ios/**/*.mode1v3
+ios/**/*.mode2v3
+ios/**/*.pbxuser
+ios/**/*.perspectivev3
+ios/**/*.xcworkspace/xcuserdata
+ios/Runner.xcworkspace/
+
+# Web
+web/packages/
+
+# macOS
+macos/Flutter/
+
+# Testing
+coverage/
+.test_coverage.dart
+
+# Environment
+.env
+.env*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*.iml
+
+# OS
+.DS_Store
+Thumbs.db
+```
+
+**📝 Action:** Generate and write `.gitignore` to project root.
+
+**Selection logic:**
+
+- If React Native → Use React Native patterns
+- If Flutter → Use Flutter patterns
+- If Expo detected → Add Expo-specific patterns
+
+```
+✅ Generated: .gitignore
+   Patterns included: [React Native | Flutter] + Platform-specific
+```
+---
+## 8.4: Generate AGENT.md (Master Index)
+
+- **Template:** `.ai-flow/templates/AGENT.template.md`
+- **Content from:** ALL phases (this is the aggregator)
+- **Requirements:**
+  - **CRITICAL:** Re-read ALL previously generated documents before filling
+  - List all documents with descriptions
+  - Provide quick reference to tech stack
+  - Include critical architecture rules
+  - Link to all specs and docs
+  - Summarize key decisions from each phase
+  - Include common commands
+
+**Structure:**
+
+```markdown
+# 🤖 AGENT.md - Universal AI Assistant Configuration
+
+## 📚 Documentation Index
+
+### Core Documents
+
+1. **project-brief.md** - [1-sentence description]
+2. **ai-instructions.md** - [1-sentence description]
+
+### Documentation
+
+3. **docs/app-structure.md** - [1-sentence description]
+4. **docs/architecture.md** - [1-sentence description]
+5. **docs/platform-guides.md** - [1-sentence description]
+6. **docs/navigation-guide.md** - [1-sentence description]
+7. **docs/code-standards.md** - [1-sentence description]
+8. **docs/testing.md** - [1-sentence description]
+9. **docs/app-store.md** - [1-sentence description]
+10. **docs/contributing.md** - [1-sentence description]
+
+### Specifications
+
+11. **specs/build-configuration.md** - [1-sentence description]
+12. **specs/deployment.md** - [1-sentence description]
+13. **.env.example** - Environment variables template
+14. **README.md** - Project overview and setup
+
+## 🎯 Quick Reference
+
+### Tech Stack
+
+[List from Phase 1 & 3]
+
+### Critical Rules
+
+[Key rules from code-standards.md and ai-instructions.md]
+
+### Common Commands
+
+[From deployment.md and contributing.md]
+```
+
+**📝 Action:**
+
+```
+🔄 Re-reading all generated documents for AGENT.md generation...
+
+✅ Reading .ai-flow/project-brief.md
+✅ Reading .ai-flow/ai-instructions.md
+✅ Reading docs/app-structure.md
+✅ Reading docs/architecture.md
+✅ Reading docs/platform-guides.md
+✅ Reading docs/navigation-guide.md
+✅ Reading docs/code-standards.md
+✅ Reading docs/testing.md
+✅ Reading docs/app-store.md
+✅ Reading specs/build-configuration.md
+✅ Reading specs/deployment.md
+✅ Reading docs/contributing.md
+
+✅ All context loaded!
+```
+
+**📝 Action:** Write the complete file to `.ai-flow/AGENT.md`
+
+```
+✅ Generated: .ai-flow/AGENT.md (Master Index)
+```
+---
+## 8.5: Generate README.md (Intelligent Merge)
+
+- **Template:** `.ai-flow/templates/README.template.md`
+- **Content from:** ALL phases (most comprehensive document)
+- **Requirements:**
+  - **CRITICAL:** Re-read ALL documents before generating
+  - Include project overview from Phase 1
+  - List features from Phase 1
+  - Show tech stack from Phase 1 & 3
+  - Include quick start from Phase 7
+  - Link to all documentation
+  - Include deployment info from Phase 7
+  - Add app store links placeholders
+
+**Merge Strategy (if framework README exists):**
+
+1. **Read framework's README.md** (if exists from step 8.2)
+2. **Extract valuable sections:**
+   - Installation commands specific to framework
+   - Framework-specific setup instructions
+   - Running on iOS/Android commands
+   - Troubleshooting tips
+3. **Use AI Flow template as base structure:**
+   - Project name and description (from Phase 1)
+   - Features (from Phase 1)
+   - Tech stack (from Phase 1 & 3)
+   - Architecture overview (link to docs/architecture.md)
+   - Getting started (merge with framework's instructions)
+   - Platform setup (iOS/Android requirements)
+   - Testing (link to docs/testing.md)
+   - Deployment (from Phase 7)
+   - Contributing (link to docs/contributing.md)
+4. **Insert framework-specific content** in "Getting Started" section
+5. **Ensure no duplication**
+6. **Validate all links** work correctly
+
+**📝 Action:** Write the complete file to `.ai-flow/README.md`
+
+```
+✅ Generated: .ai-flow/README.md
+   [If merged] Merged with framework's setup instructions
+```
+---
+## 8.6: Create Tool-Specific Configs
+
+**Based on AI tool selection from Phase 1:**
+
+### If Claude selected:
+
+**Create `.clauderules`:**
+
+```markdown
+# Claude AI Configuration
+
+This project uses AI Flow documentation structure.
+
+## Primary Reference
+
+Read `.ai-flow/AGENT.md` first for complete documentation index.
+
+## Key Documents
+
+- Project overview: `.ai-flow/project-brief.md`
+- AI instructions: `.ai-flow/ai-instructions.md`
+- Architecture: `docs/architecture.md`
+- App Structure: `docs/app-structure.md`
+- Platform Guides: `docs/platform-guides.md`
+- Navigation: `docs/navigation-guide.md`
+- Code standards: `docs/code-standards.md`
+
+## Working Instructions
+
+When writing code:
+
+1. Follow patterns in `docs/code-standards.md`
+2. Reference app structure in `docs/app-structure.md`
+3. Follow platform guidelines from `docs/platform-guides.md`
+4. Implement navigation per `docs/navigation-guide.md`
+5. Write tests per `docs/testing.md`
+
+## Critical Rules
+
+[Extract top 5-10 rules from ai-instructions.md]
+```
+
+### If Cursor selected:
+
+**Create `.cursorrules`:**
+
+```markdown
+# Cursor AI Configuration
+
+Project uses AI Flow documentation in `.ai-flow/` directory.
+
+## Documentation Index
+
+See `.ai-flow/AGENT.md` for complete document list.
+
+## Quick Reference
+
+- Tech Stack: [from Phase 1 & 3]
+- Architecture: `docs/architecture.md`
+- Platform Guides: `docs/platform-guides.md`
+- Code Standards: `docs/code-standards.md`
+
+## Code Generation Rules
+
+[Extract key rules from ai-instructions.md]
+```
+
+### If GitHub Copilot selected:
+
+**Create `.github/copilot-instructions.md`:**
+
+```markdown
+# GitHub Copilot Instructions
+
+## Project Context
+
+[Project description from Phase 1]
+
+## Documentation Structure
+
+This project uses AI Flow. All documentation is in `.ai-flow/` directory.
+
+Master index: `.ai-flow/AGENT.md`
+
+## Key References
+
+- Architecture: `docs/architecture.md`
+- App Structure: `docs/app-structure.md`
+- Platform Guides: `docs/platform-guides.md`
+- Navigation: `docs/navigation-guide.md`
+- Code Standards: `docs/code-standards.md`
+- Testing: `docs/testing.md`
+
+## Code Generation Guidelines
+
+[Extract guidelines from ai-instructions.md and code-standards.md]
+
+## Tech Stack
+
+[From Phase 1 & 3]
+```
+
+**📝 Action:** Generate the tool-specific config files based on selection:
+
+- 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]
+```
+---
+## 8.7: Final Validation & Success Message
+
+```
+🔍 Validating all generated files...
+
+✅ Checking for placeholder text...
+✅ Validating file references...
+✅ Ensuring all links work...
+✅ Verifying template completeness...
+
+All validations passed!
+```
+
+**Show complete summary:**
+
+```
+🎉 AI Flow Complete!
+
+Generated 15 documents successfully:
+
+Phase 1:
+✅ project-brief.md
+
+Phase 2:
+✅ docs/app-structure.md
+
+Phase 3:
+✅ docs/architecture.md
+✅ ai-instructions.md
+
+Phase 5:
+✅ docs/code-standards.md
+
+Phase 6:
+✅ docs/testing.md
+
+Phase 7:
+✅ docs/app-store.md
+✅ specs/build-configuration.md
+✅ specs/deployment.md
+✅ .env.example
+
+Phase 8:
+✅ docs/platform-guides.md
+✅ docs/navigation-guide.md
+✅ docs/contributing.md
+✅ .gitignore
+✅ README.md
+✅ AGENT.md
+
+[If framework initialized:]
+✅ [FRAMEWORK_NAME] project initialized
+
+[If README merged:]
+✅ README.md merged with framework's setup instructions
+
+Tool-specific configs:
+✅ [List generated configs]
+---
+📁 Project Structure:
+
+your-app/
+├── .ai-flow/                    # AI Flow documentation
+│   ├── AGENT.md                 ⭐ Start here!
+│   ├── project-brief.md
+│   ├── ai-instructions.md
+│   ├── docs/
+│   │   ├── app-structure.md
+│   │   ├── architecture.md
+│   │   ├── platform-guides.md
+│   │   ├── navigation-guide.md
+│   │   ├── code-standards.md
+│   │   ├── testing.md
+│   │   ├── app-store.md
+│   │   └── contributing.md
+│   ├── specs/
+│   │   ├── build-configuration.md
+│   │   └── deployment.md
+│   └── templates/               # Original templates
+├── ios/                         # iOS platform (if initialized)
+├── android/                     # Android platform (if initialized)
+├── src/ or lib/                 # Source code (if initialized)
+├── README.md
+├── .env.example
+├── .gitignore
+└── [tool configs]               # .clauderules, .cursorrules, etc.
+---
+Next steps:
+
+1. ⭐ **Read `.ai-flow/AGENT.md`** - Master index of all documentation
+2. 📖 **Review generated documents** - Customize as needed
+3. 🔧 **Set up environment** - Copy `.env.example` to `.env` and configure
+[If NOT initialized:]
+4. 🚀 **Initialize framework** - Run: `[show command from Phase 1]`
+[If initialized:]
+4. 🚀 **Install dependencies** - Run platform-specific setup:
+   • React Native: `npm install && cd ios && pod install`
+   • Flutter: `flutter pub get`
+   • Expo: `npm install`
+5. 📱 **Run on device/simulator**:
+   • iOS: `npm run ios` or `flutter run`
+   • Android: `npm run android` or `flutter run`
+6. 💾 **Initialize git** (if not done) - `git init && git add . && git commit -m "Initial commit with AI Flow docs"`
+7. 🧪 **Start developing!** - Your AI assistant now has complete project context
+---
+💡 **Remember:**
+- Documents are **living artifacts** - update them as project evolves
+- All AI assistants will reference these docs for future work
+- AGENT.md is the **single source of truth** for AI context
+
+🤖 **AI Assistant Usage:**
+Your AI assistant (Claude, Cursor, Copilot) will now:
+- ✅ Understand complete project context
+- ✅ Follow your architecture patterns
+- ✅ Generate code matching your standards
+- ✅ Reference your app structure
+- ✅ Apply platform-specific best practices
+- ✅ Write tests per your guidelines
+
+Happy building! 🎉📱
+```
+---
+## EXECUTION CHECKLIST FOR AI ASSISTANT
+
+When executing Phase 8:
+
+**8.1 Project State Detection:**
+
+- [ ] Scan for source directories (src/, lib/, app/)
+- [ ] Check for platform directories (ios/, android/)
+- [ ] Check for framework files (package.json, pubspec.yaml, etc.)
+- [ ] Check for existing README.md
+- [ ] Classify project: New / Initialized / Existing
+- [ ] Present detection results
+
+**8.2 Framework Initialization (if new project):**
+
+- [ ] Ask user if they want to initialize
+- [ ] If yes:
+  - [ ] Backup .ai-flow/ docs
+  - [ ] Execute framework CLI command
+  - [ ] Restore .ai-flow/ docs
+  - [ ] Handle README.md conflict
+- [ ] If no: Show manual command and continue
+
+**8.3 Generate Final Documentation:**
+
+- [ ] Re-read ALL previously generated documents
+- [ ] Generate docs/platform-guides.md
+- [ ] Generate docs/navigation-guide.md
+- [ ] Generate docs/contributing.md
+
+**8.4 Generate AGENT.md:**
+
+- [ ] Re-read ALL documents again
+- [ ] Create master index
+- [ ] Include quick reference
+- [ ] Validate all links
+
+**8.5 Generate README.md:**
+
+- [ ] Re-read ALL documents
+- [ ] If framework README exists: merge intelligently
+- [ ] If no framework README: create from template
+- [ ] Validate all internal links
+
+**8.6 Create Tool-Specific Configs:**
+
+- [ ] Create configs based on AI tool selection
+
+**8.7 Final Validation:**
+
+- [ ] Check for placeholders
+- [ ] Validate file references
+- [ ] Show success message
+
+**ESTIMATED TIME:** 10-15 minutes
+---
+**Next Phase:** Phase 9 - Project Roadmap (Post-Documentation)
+
+Read: `.ai-flow/prompts/mobile/flow-build-phase-9.md`
+
+---
+
+**Last Updated:** 2025-12-21
+**Version:** 2.1.9
+
+
+
+