ai-flow-dev 2.1.2 → 2.1.4

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

@@ -3,28 +3,24 @@
 **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/analysis.json`) and update all affected documentation files automatically.
-
----
-
+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
 
 ```
-First, check if `.ai-flow/analysis.json` exists:
+First, check if `.ai-flow/cache/docs-analysis.json` exists:
 
 - ✅ If exists → Proceed to Step 2 (Compare Changes)
 - ❌ If NOT exists → Execute full Phase 0 analysis first:
   - Run complete frontend code analysis (as described in Phase 0)
-  - Create `.ai-flow/analysis.json` with current state
+  - Create `.ai-flow/cache/docs-analysis.json` with current state
   - Then proceed to Step 2
 ```
 
@@ -45,7 +41,7 @@ First, check if `.ai-flow/analysis.json` exists:
 
 2. **Compare with Previous State:**
 
-   - Load `.ai-flow/analysis.json`
+   - Load `.ai-flow/cache/docs-analysis.json`
    - Compare current state vs previous state
    - Detect changes in:
      - **Components:** New, modified, or deleted components
@@ -149,9 +145,9 @@ No updates required.
    - Add new test examples if patterns changed
    - Maintain existing testing strategy
 
-2. **Update `analysis.json`:**
+2. **Update `docs-analysis.json`:**
 
-   - Save current state to `.ai-flow/analysis.json`
+   - Save current state to `.ai-flow/cache/docs-analysis.json`
    - Update timestamp
    - Include all detected changes in metadata
 
@@ -176,7 +172,7 @@ No updates required.
 - Added dependency "@tanstack/react-query"
 - Updated tools section
 
-✅ analysis.json updated with new state
+✅ docs-analysis.json updated with new state
 ```
 
 ### Step 5: Handle Cancellation
@@ -186,9 +182,7 @@ No updates required.
 ```
 Update cancelled. Run `/flow-docs-sync` when you're ready to update the documentation.
 ```
-
----
-
+---
 ## Change Detection Rules
 
 ### Components Detection
@@ -280,9 +274,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:**
@@ -299,7 +291,7 @@ Update cancelled. Run `/flow-docs-sync` when you're ready to update the document
 
 3. **Update Analysis File:**
 
-   - Always update `.ai-flow/analysis.json` after document updates
+   - Always update `.ai-flow/cache/docs-analysis.json` after document updates
    - Include timestamp and change summary
    - Save complete current state for next comparison
 
@@ -308,9 +300,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:
@@ -364,9 +354,7 @@ graph TD
     style Btn fill:#fce4ec
 ```
 ````
-
----
-
+---
 ### State Management Diagrams (state-management.md)
 
 **Diagram Types:** `graph LR`, `sequenceDiagram`, `graph TD`
@@ -410,9 +398,7 @@ sequenceDiagram
     Component-->>User: UI Updated
 ```
 ````
-
----
-
+---
 ### Routing Diagrams (architecture.md or routing.md)
 
 **Diagram Type:** `graph TD`
@@ -431,9 +417,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`
@@ -474,9 +458,7 @@ graph TB
 ````
 
 **Use for:** System architecture overview, integration documentation, onboarding
-
----
-
+---
 ### Common Formatting Rules (ALL Frontend Diagrams)
 
 **CRITICAL - Code Fence Syntax:**
@@ -510,16 +492,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 analysis.json is corrupted, regenerate it
+   - If docs-analysis.json is corrupted, regenerate it
    - If comparison fails, show error and suggest full Phase 0 re-run
-
----
-
+---
 ## Example Execution
 
 ```
@@ -549,14 +527,15 @@ AI:
 - Added new Zustand store (useCartStore)
 - Updated state management patterns section
 
-✅ analysis.json updated with new state
+✅ docs-analysis.json updated with new state
 
 Documentation synchronized successfully.
 ```
+---
+**BEGIN EXECUTION when user runs `/flow-docs-sync`**
+
 
----
 
-**BEGIN EXECUTION when user runs `/flow-docs-sync`**
 
 
 

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

@@ -3,9 +3,7 @@
 **⚡ AUTOMATED ANALYSIS - Minimal User Input Required**
 
 This phase automatically analyzes your existing mobile codebase to pre-populate answers for the build questionnaire.
-
----
-
+---
 ## 🎯 Objective
 
 Detect the current mobile stack, architecture patterns, and configuration from existing code to:
@@ -14,9 +12,7 @@ Detect the current mobile stack, architecture patterns, and configuration from e
 2. **Validate assumptions** - Confirm detected patterns with user
 3. **Save time** - Reduce questionnaire from ~100 min to ~50 min
 4. **Maintain accuracy** - User can override any detection
-
----
-
+---
 ## 📋 Detection Layers (Progressive)
 
 ### Layer 0: Cache Check (0-2 seconds)
@@ -24,6 +20,7 @@ Detect the current mobile stack, architecture patterns, and configuration from e
 Check if `.ai-flow/cache/mobile-context.json` exists and is fresh (<7 days old).
 
 **If found:**
+
 ```json
 {
   "platform": "iOS + Android",
@@ -42,9 +39,7 @@ Check if `.ai-flow/cache/mobile-context.json` exists and is fresh (<7 days old).
 **If yes:** Skip to validation step
 
 **If no or cache doesn't exist:** Proceed to Layer 1
-
----
-
+---
 ### Layer 1: Fast Metadata Scan (10-20 seconds)
 
 **Purpose:** Detect framework, platform, build tool, TypeScript
@@ -65,15 +60,21 @@ Check if `.ai-flow/cache/mobile-context.json` exists and is fresh (<7 days old).
 const pkg = await detectPackageFile();
 
 // 2. Detect Mobile Framework
-const framework =
-  pkg.dependencies?.['react-native'] ? 'React Native' :
-  await fs.exists('pubspec.yaml') ? 'Flutter' :
-  await fs.exists('ios/') && await fs.exists('android/') ? 'Native (iOS + Android)' :
-  await fs.exists('ios/') ? 'Native iOS (Swift)' :
-  await fs.exists('android/') ? 'Native Android (Kotlin)' :
-  pkg.dependencies?.['@ionic/core'] ? 'Ionic' :
-  pkg.dependencies?.['@capacitor/core'] ? 'Capacitor' :
-  null;
+const framework = pkg.dependencies?.['react-native']
+  ? 'React Native'
+  : (await fs.exists('pubspec.yaml'))
+    ? 'Flutter'
+    : (await fs.exists('ios/')) && (await fs.exists('android/'))
+      ? 'Native (iOS + Android)'
+      : (await fs.exists('ios/'))
+        ? 'Native iOS (Swift)'
+        : (await fs.exists('android/'))
+          ? 'Native Android (Kotlin)'
+          : pkg.dependencies?.['@ionic/core']
+            ? 'Ionic'
+            : pkg.dependencies?.['@capacitor/core']
+              ? 'Capacitor'
+              : null;
 
 // 3. Detect Platform Support
 const platforms = [];
@@ -81,50 +82,68 @@ if (await fs.exists('ios/')) platforms.push('iOS');
 if (await fs.exists('android/')) platforms.push('Android');
 
 // 4. Detect Navigation Library
-const navigation =
-  pkg.dependencies?.['@react-navigation/native'] ? 'React Navigation' :
-  pkg.dependencies?.['react-native-navigation'] ? 'React Native Navigation' :
-  pkg.dependencies?.['go_router'] ? 'GoRouter' :
-  pkg.dependencies?.['auto_route'] ? 'AutoRoute' :
-  null;
+const navigation = pkg.dependencies?.['@react-navigation/native']
+  ? 'React Navigation'
+  : pkg.dependencies?.['react-native-navigation']
+    ? 'React Native Navigation'
+    : pkg.dependencies?.['go_router']
+      ? 'GoRouter'
+      : pkg.dependencies?.['auto_route']
+        ? 'AutoRoute'
+        : null;
 
 // 5. Detect State Management
-const stateManagement =
-  pkg.dependencies?.['@reduxjs/toolkit'] ? 'Redux Toolkit' :
-  pkg.dependencies?.zustand ? 'Zustand' :
-  pkg.dependencies?.mobx ? 'MobX' :
-  pkg.dependencies?.provider ? 'Provider' :
-  pkg.dependencies?.['flutter_riverpod'] ? 'Riverpod' :
-  pkg.dependencies?.['flutter_bloc'] ? 'Bloc' :
-  null;
+const stateManagement = pkg.dependencies?.['@reduxjs/toolkit']
+  ? 'Redux Toolkit'
+  : pkg.dependencies?.zustand
+    ? 'Zustand'
+    : pkg.dependencies?.mobx
+      ? 'MobX'
+      : pkg.dependencies?.provider
+        ? 'Provider'
+        : pkg.dependencies?.['flutter_riverpod']
+          ? 'Riverpod'
+          : pkg.dependencies?.['flutter_bloc']
+            ? 'Bloc'
+            : null;
 
 // 6. Detect Storage Solution
-const storage =
-  pkg.dependencies?.['@react-native-async-storage/async-storage'] ? 'AsyncStorage' :
-  pkg.dependencies?.['react-native-mmkv'] ? 'MMKV' :
-  pkg.dependencies?.['@nozbe/watermelondb'] ? 'WatermelonDB' :
-  pkg.dependencies?.realm ? 'Realm' :
-  pkg.dependencies?.hive ? 'Hive' :
-  await fs.exists('ios/DataModel.xcdatamodeld') ? 'Core Data' :
-  await fs.exists('android/app/src/main/java/**/RoomDatabase.kt') ? 'Room' :
-  null;
+const storage = pkg.dependencies?.['@react-native-async-storage/async-storage']
+  ? 'AsyncStorage'
+  : pkg.dependencies?.['react-native-mmkv']
+    ? 'MMKV'
+    : pkg.dependencies?.['@nozbe/watermelondb']
+      ? 'WatermelonDB'
+      : pkg.dependencies?.realm
+        ? 'Realm'
+        : pkg.dependencies?.hive
+          ? 'Hive'
+          : (await fs.exists('ios/DataModel.xcdatamodeld'))
+            ? 'Core Data'
+            : (await fs.exists('android/app/src/main/java/**/RoomDatabase.kt'))
+              ? 'Room'
+              : null;
 
 // 7. Detect TypeScript/Dart
 const typescript = await fs.exists('tsconfig.json');
 const dart = await fs.exists('pubspec.yaml');
 
 // 8. Detect Testing Framework
-const unitTest =
-  pkg.devDependencies?.jest ? 'Jest' :
-  pkg.devDependencies?.vitest ? 'Vitest' :
-  await fs.exists('test/') && dart ? 'Flutter Test' :
-  null;
-
-const e2eTest =
-  pkg.devDependencies?.['detox'] ? 'Detox' :
-  pkg.devDependencies?.['@maestrohq/cli'] ? 'Maestro' :
-  pkg.devDependencies?.appium ? 'Appium' :
-  null;
+const unitTest = pkg.devDependencies?.jest
+  ? 'Jest'
+  : pkg.devDependencies?.vitest
+    ? 'Vitest'
+    : (await fs.exists('test/')) && dart
+      ? 'Flutter Test'
+      : null;
+
+const e2eTest = pkg.devDependencies?.['detox']
+  ? 'Detox'
+  : pkg.devDependencies?.['@maestrohq/cli']
+    ? 'Maestro'
+    : pkg.devDependencies?.appium
+      ? 'Appium'
+      : null;
 ```
 
 #### Layer 1 Output
@@ -142,9 +161,7 @@ Testing: Jest + Detox
 
 Continue to Layer 2 for structural analysis? (Y/n)
 ```
-
----
-
+---
 ### Layer 2: Structural Analysis (30-90 seconds)
 
 **Purpose:** Analyze navigation structure, component organization, and architecture patterns
@@ -163,10 +180,10 @@ Continue to Layer 2 for structural analysis? (Y/n)
 const navigationPattern = detectNavigationPattern(srcFiles);
 
 function detectNavigationPattern(files: string[]): string {
-  const hasStack = files.some(f => f.includes('Stack') || f.includes('createStackNavigator'));
-  const hasTab = files.some(f => f.includes('Tab') || f.includes('createBottomTabNavigator'));
-  const hasDrawer = files.some(f => f.includes('Drawer') || f.includes('createDrawerNavigator'));
-  
+  const hasStack = files.some((f) => f.includes('Stack') || f.includes('createStackNavigator'));
+  const hasTab = files.some((f) => f.includes('Tab') || f.includes('createBottomTabNavigator'));
+  const hasDrawer = files.some((f) => f.includes('Drawer') || f.includes('createDrawerNavigator'));
+
   if (hasTab && hasStack) return 'Tab + Stack Navigation';
   if (hasDrawer && hasStack) return 'Drawer + Stack Navigation';
   if (hasStack) return 'Stack Navigation';
@@ -178,11 +195,11 @@ function detectNavigationPattern(files: string[]): string {
 const architecturePattern = detectArchitecture(srcFiles);
 
 function detectArchitecture(files: string[]): string {
-  const hasFeatures = files.some(f => f.includes('/features/'));
-  const hasDomains = files.some(f => f.includes('/domain/'));
-  const hasPresentation = files.some(f => f.includes('/presentation/'));
-  const hasClean = files.some(f => f.includes('/data/') && f.includes('/domain/'));
-  
+  const hasFeatures = files.some((f) => f.includes('/features/'));
+  const hasDomains = files.some((f) => f.includes('/domain/'));
+  const hasPresentation = files.some((f) => f.includes('/presentation/'));
+  const hasClean = files.some((f) => f.includes('/data/') && f.includes('/domain/'));
+
   if (hasClean) return 'Clean Architecture';
   if (hasFeatures) return 'Feature-based';
   if (hasDomains) return 'Domain-driven';
@@ -194,12 +211,12 @@ function detectArchitecture(files: string[]): string {
 const componentPattern = detectComponentPattern(srcFiles);
 
 function detectComponentPattern(files: string[]): string {
-  const hasAtomic = files.some(f =>
-    f.includes('/atoms/') || f.includes('/molecules/') || f.includes('/organisms/')
+  const hasAtomic = files.some(
+    (f) => f.includes('/atoms/') || f.includes('/molecules/') || f.includes('/organisms/')
   );
-  const hasScreens = files.some(f => f.includes('/screens/'));
-  const hasWidgets = files.some(f => f.includes('/widgets/'));
-  
+  const hasScreens = files.some((f) => f.includes('/screens/'));
+  const hasWidgets = files.some((f) => f.includes('/widgets/'));
+
   if (hasAtomic) return 'Atomic Design';
   if (hasScreens && hasWidgets) return 'Screens + Widgets';
   if (hasScreens) return 'Screens-based';
@@ -226,14 +243,13 @@ Component Pattern: Screens + Components
 
 Continue to Layer 3 for deep analysis? (Y/n)
 ```
-
----
-
+---
 ### Layer 3: Selective Deep Analysis (Optional, 60-120 seconds)
 
 **Purpose:** Extract advanced patterns, permissions, and native integrations
 
 **Only proceed if:**
+
 - User confirms (not automatic)
 - Project is large (>20 screens)
 - Accuracy is critical
@@ -246,32 +262,32 @@ const permissions = detectPermissions(srcFiles, platformFiles);
 
 function detectPermissions(srcFiles: string[], platformFiles: string[]): string[] {
   const detected = [];
-  
+
   // Check Info.plist (iOS)
-  const infoPlist = platformFiles.find(f => f.includes('Info.plist'));
+  const infoPlist = platformFiles.find((f) => f.includes('Info.plist'));
   if (infoPlist) {
     const content = fs.readFileSync(infoPlist, 'utf-8');
     if (content.includes('NSCameraUsageDescription')) detected.push('Camera');
     if (content.includes('NSLocationWhenInUseUsageDescription')) detected.push('Location');
     if (content.includes('NSPhotoLibraryUsageDescription')) detected.push('Photo Library');
   }
-  
+
   // Check AndroidManifest.xml (Android)
-  const manifest = platformFiles.find(f => f.includes('AndroidManifest.xml'));
+  const manifest = platformFiles.find((f) => f.includes('AndroidManifest.xml'));
   if (manifest) {
     const content = fs.readFileSync(manifest, 'utf-8');
     if (content.includes('android.permission.CAMERA')) detected.push('Camera');
     if (content.includes('android.permission.ACCESS_FINE_LOCATION')) detected.push('Location');
   }
-  
+
   // Check code for permission requests
-  srcFiles.forEach(file => {
+  srcFiles.forEach((file) => {
     const content = fs.readFileSync(file, 'utf-8');
     if (content.includes('requestPermission') || content.includes('Permissions.')) {
       // Extract permission type from context
     }
   });
-  
+
   return detected;
 }
 
@@ -280,21 +296,19 @@ const nativeModules = detectNativeModules(srcFiles);
 
 function detectNativeModules(files: string[]): string[] {
   const modules = [];
-  
-  files.forEach(file => {
+
+  files.forEach((file) => {
     const content = fs.readFileSync(file, 'utf-8');
     if (content.includes('react-native-camera')) modules.push('Camera');
     if (content.includes('@react-native-async-storage')) modules.push('AsyncStorage');
     if (content.includes('react-native-maps')) modules.push('Maps');
     if (content.includes('@react-native-firebase')) modules.push('Firebase');
   });
-  
+
   return modules;
 }
 ```
-
----
-
+---
 ## ✅ Validation & Confirmation
 
 ### Present Findings
@@ -302,10 +316,9 @@ function detectNativeModules(files: string[]): string[] {
 After detection, show user a summary and ask for confirmation:
 
 ```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
 🔍 MOBILE STACK DETECTED
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+---
 ✅ Platform: iOS + Android
 ✅ Framework: React Native 0.72.0
 ✅ TypeScript: Yes
@@ -333,9 +346,7 @@ This will reduce the questionnaire from ~100 min to ~50 min.
 
 Proceed to Phase 1? (Y/n)
 ```
-
----
-
+---
 ## 💾 Cache Storage
 
 Save detected context for future use:
@@ -363,9 +374,7 @@ Save detected context for future use:
 ```
 
 **Cache invalidation:** 7 days or when package.json/pubspec.yaml is modified
-
----
-
+---
 ## 🚀 Next Steps
 
 After Phase 0 completes:
@@ -377,9 +386,7 @@ Next: Proceed to Phase 1 (Platform & Framework Selection)
 
 Read: .ai-flow/prompts/mobile/flow-build-phase-1-platform.md
 ```
-
----
-
+---
 **Last Updated:** 2025-01-XX
 
 **Version:** 1.4.0