ai-flow-dev 2.1.2 → 2.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/README.md +28 -40
  2. package/dist/cli.js +69 -47
  3. package/dist/cli.js.map +1 -1
  4. package/package.json +5 -5
  5. package/prompts/backend/flow-build-phase-0.md +96 -84
  6. package/prompts/backend/flow-build-phase-1.md +10 -18
  7. package/prompts/backend/flow-build-phase-10.md +199 -583
  8. package/prompts/backend/flow-build-phase-2.md +152 -86
  9. package/prompts/backend/flow-build-phase-3.md +108 -68
  10. package/prompts/backend/flow-build-phase-4.md +5 -8
  11. package/prompts/backend/flow-build-phase-5.md +39 -12
  12. package/prompts/backend/flow-build-phase-6.md +29 -8
  13. package/prompts/backend/flow-build-phase-7.md +121 -41
  14. package/prompts/backend/flow-build-phase-8.md +28 -65
  15. package/prompts/backend/flow-build-phase-9.md +267 -1298
  16. package/prompts/backend/flow-build.md +881 -957
  17. package/prompts/backend/flow-dev-commit.md +27 -50
  18. package/prompts/backend/flow-dev-feature.md +1929 -2017
  19. package/prompts/backend/flow-dev-fix.md +936 -964
  20. package/prompts/backend/flow-dev-refactor.md +672 -701
  21. package/prompts/backend/flow-dev-review.md +356 -389
  22. package/prompts/backend/flow-dev-work.md +1066 -1118
  23. package/prompts/backend/flow-docs-sync.md +31 -210
  24. package/prompts/frontend/flow-build-phase-0.md +503 -484
  25. package/prompts/frontend/flow-build-phase-1.md +445 -433
  26. package/prompts/frontend/flow-build-phase-2.md +910 -957
  27. package/prompts/frontend/flow-build-phase-3.md +692 -664
  28. package/prompts/frontend/flow-build-phase-4.md +478 -463
  29. package/prompts/frontend/flow-build-phase-5.md +488 -467
  30. package/prompts/frontend/flow-build-phase-6.md +571 -550
  31. package/prompts/frontend/flow-build-phase-7.md +560 -592
  32. package/prompts/frontend/flow-build-phase-8.md +17 -42
  33. package/prompts/frontend/flow-build.md +457 -503
  34. package/prompts/frontend/flow-docs-sync.md +24 -45
  35. package/prompts/mobile/flow-build-phase-0.md +104 -97
  36. package/prompts/mobile/flow-build-phase-1.md +137 -122
  37. package/prompts/mobile/flow-build-phase-2.md +123 -130
  38. package/prompts/mobile/flow-build-phase-3.md +144 -149
  39. package/prompts/mobile/flow-build-phase-4.md +140 -132
  40. package/prompts/mobile/flow-build-phase-5.md +70 -70
  41. package/prompts/mobile/flow-build-phase-6.md +136 -134
  42. package/prompts/mobile/flow-build-phase-7.md +24 -58
  43. package/prompts/mobile/flow-build-phase-8.md +17 -42
  44. package/prompts/mobile/flow-build.md +47 -97
  45. package/prompts/mobile/flow-docs-sync.md +23 -42
  46. package/prompts/shared/mermaid-guidelines.md +106 -0
  47. package/prompts/shared/scope-levels.md +126 -0
  48. package/prompts/shared/story-points.md +65 -0
  49. package/prompts/shared/task-format.md +86 -0
  50. package/templates/AGENT.template.md +194 -15
  51. package/templates/backend/README.template.md +2 -32
  52. package/templates/backend/ai-instructions.template.md +2 -32
  53. package/templates/backend/copilot-instructions.template.md +2 -22
  54. package/templates/backend/docs/api.template.md +89 -20
  55. package/templates/backend/docs/architecture.template.md +165 -53
  56. package/templates/backend/docs/business-flows.template.md +7 -14
  57. package/templates/backend/docs/code-standards.template.md +2 -38
  58. package/templates/backend/docs/contributing.template.md +2 -16
  59. package/templates/backend/docs/data-model.template.md +125 -21
  60. package/templates/backend/docs/operations.template.md +179 -50
  61. package/templates/backend/docs/testing.template.md +2 -42
  62. package/templates/backend/project-brief.template.md +2 -28
  63. package/templates/backend/specs/configuration.template.md +2 -14
  64. package/templates/backend/specs/security.template.md +2 -32
  65. package/templates/frontend/README.template.md +2 -18
  66. package/templates/frontend/ai-instructions.template.md +2 -20
  67. package/templates/frontend/docs/api-integration.template.md +12 -30
  68. package/templates/frontend/docs/components.template.md +2 -28
  69. package/templates/frontend/docs/error-handling.template.md +11 -27
  70. package/templates/frontend/docs/operations.template.md +8 -18
  71. package/templates/frontend/docs/performance.template.md +8 -18
  72. package/templates/frontend/docs/pwa.template.md +8 -18
  73. package/templates/frontend/docs/state-management.template.md +2 -28
  74. package/templates/frontend/docs/styling.template.md +2 -26
  75. package/templates/frontend/docs/testing.template.md +2 -28
  76. package/templates/frontend/project-brief.template.md +2 -16
  77. package/templates/frontend/specs/accessibility.template.md +8 -18
  78. package/templates/frontend/specs/configuration.template.md +2 -24
  79. package/templates/frontend/specs/security.template.md +10 -24
  80. package/templates/fullstack/README.template.md +17 -47
  81. package/templates/fullstack/ai-instructions.template.md +17 -45
  82. package/templates/fullstack/project-brief.template.md +16 -42
  83. package/templates/fullstack/specs/configuration.template.md +16 -42
  84. package/templates/mobile/README.template.md +11 -29
  85. package/templates/mobile/ai-instructions.template.md +11 -27
  86. package/templates/mobile/docs/app-store.template.md +11 -29
  87. package/templates/mobile/docs/architecture.template.md +14 -38
  88. package/templates/mobile/docs/native-features.template.md +16 -44
  89. package/templates/mobile/docs/navigation.template.md +9 -23
  90. package/templates/mobile/docs/offline-strategy.template.md +10 -26
  91. package/templates/mobile/docs/permissions.template.md +9 -23
  92. package/templates/mobile/docs/state-management.template.md +12 -32
  93. package/templates/mobile/docs/testing.template.md +14 -38
  94. package/templates/mobile/project-brief.template.md +12 -30
  95. package/templates/mobile/specs/build-configuration.template.md +10 -26
  96. package/templates/mobile/specs/deployment.template.md +9 -23
@@ -3,9 +3,7 @@
3
3
  **Duration:** 15-20 minutes
4
4
  **Questions:** ~12 questions
5
5
  **Output:** docs/app-store.md, specs/build-configuration.md, specs/deployment.md, parts of ai-instructions.md
6
-
7
- ---
8
-
6
+ ---
9
7
  ## 🎯 Objective
10
8
 
11
9
  Define your app store deployment strategy:
@@ -15,9 +13,7 @@ Define your app store deployment strategy:
15
13
  3. How will you handle versioning?
16
14
  4. What code signing strategy?
17
15
  5. What beta testing approach?
18
-
19
- ---
20
-
16
+ ---
21
17
  ## 📋 Questions
22
18
 
23
19
  ### Question 7.1: Target App Stores
@@ -48,9 +44,7 @@ D) **Enterprise Distribution Only**
48
44
  - Best for: Enterprise apps
49
45
 
50
46
  **Your answer:**
51
-
52
- ---
53
-
47
+ ---
54
48
  ### Question 7.2: CI/CD Pipeline
55
49
 
56
50
  **What CI/CD tool will you use for builds and deployment?**
@@ -86,9 +80,7 @@ E) **Manual Builds**
86
80
  - Best for: Learning, small projects
87
81
 
88
82
  **Your answer:**
89
-
90
- ---
91
-
83
+ ---
92
84
  ### Question 7.3: Versioning Strategy
93
85
 
94
86
  **How will you version your app?**
@@ -122,9 +114,7 @@ C) **Build Number Only**
122
114
 
123
115
  - A) ⭐ **Incrementing integer** (1, 2, 3, ...)
124
116
  - B) **Based on version** (e.g., 1.2.3 → 10203)
125
-
126
- ---
127
-
117
+ ---
128
118
  ### Question 7.4: Code Signing Strategy
129
119
 
130
120
  **How will you handle code signing?**
@@ -132,7 +122,6 @@ C) **Build Number Only**
132
122
  **For iOS:**
133
123
 
134
124
  - A) ⭐ **Automatic Signing** (Recommended)
135
-
136
125
  - Xcode manages certificates
137
126
  - Easier for most developers
138
127
  - Best for: Most apps
@@ -145,7 +134,6 @@ C) **Build Number Only**
145
134
  **For Android:**
146
135
 
147
136
  - A) ⭐ **Automatic Signing** (Recommended)
148
-
149
137
  - Gradle manages keystores
150
138
  - Easier for most developers
151
139
  - Best for: Most apps
@@ -160,16 +148,13 @@ C) **Build Number Only**
160
148
  **Keystore management:**
161
149
 
162
150
  - A) ⭐ **Store in CI/CD secrets** (Recommended)
163
-
164
151
  - GitHub Secrets, Bitrise Secrets, etc.
165
152
  - Secure, automated
166
153
 
167
154
  - B) **Store locally**
168
155
  - Manual management
169
156
  - Best for: Small teams
170
-
171
- ---
172
-
157
+ ---
173
158
  ### Question 7.5: Beta Testing Strategy
174
159
 
175
160
  **How will you handle beta testing?**
@@ -203,9 +188,7 @@ E) **No Beta Testing**
203
188
  - Best for: MVPs, internal apps
204
189
 
205
190
  **Your answer:**
206
-
207
- ---
208
-
191
+ ---
209
192
  ### Question 7.6: Release Strategy
210
193
 
211
194
  **What release strategy will you use?**
@@ -228,9 +211,7 @@ C) **Full Release**
228
211
  - Best for: Small updates, bug fixes
229
212
 
230
213
  **Your answer:**
231
-
232
- ---
233
-
214
+ ---
234
215
  ### Question 7.7: App Store Metadata
235
216
 
236
217
  **What metadata will you prepare for stores?**
@@ -251,9 +232,7 @@ C) **Full Release**
251
232
  - [ ] Feature graphic (Android)
252
233
 
253
234
  **Your answer:**
254
-
255
- ---
256
-
235
+ ---
257
236
  ### Question 7.8: Screenshot Automation
258
237
 
259
238
  **Will you automate screenshot generation?**
@@ -275,9 +254,7 @@ C) **No - Manual Screenshots**
275
254
  - Best for: Small teams, infrequent updates
276
255
 
277
256
  **Your answer:**
278
-
279
- ---
280
-
257
+ ---
281
258
  ### Question 7.9: App Review Preparation
282
259
 
283
260
  **How will you prepare for app review?**
@@ -301,9 +278,7 @@ C) **No - Manual Screenshots**
301
278
  - [ ] Test in internal testing first
302
279
 
303
280
  **Your answer:**
304
-
305
- ---
306
-
281
+ ---
307
282
  ### Question 7.10: Update Frequency
308
283
 
309
284
  **How often will you release updates?**
@@ -329,9 +304,7 @@ D) **Monthly**
329
304
  - Best for: Stable apps
330
305
 
331
306
  **Your answer:**
332
-
333
- ---
334
-
307
+ ---
335
308
  ### Question 7.11: Rollback Strategy
336
309
 
337
310
  **How will you handle rollbacks?**
@@ -352,9 +325,7 @@ C) **No Rollback Plan**
352
325
  - Best for: Very small apps
353
326
 
354
327
  **Your answer:**
355
-
356
- ---
357
-
328
+ ---
358
329
  ### Question 7.12: Monitoring & Analytics
359
330
 
360
331
  **What monitoring will you use post-deployment?**
@@ -381,18 +352,15 @@ D) **Custom Analytics**
381
352
  - Best for: Advanced analytics
382
353
 
383
354
  **Your answer:**
384
-
385
- ---
386
-
355
+ ---
387
356
  ## ✅ Phase 7 Completion
388
357
 
389
358
  After answering all questions, summarize:
390
359
 
391
360
  ```
392
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
361
+ ---
393
362
  ✅ Phase 7 Complete: Store Deployment
394
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
395
-
363
+ ---
396
364
  Selected Deployment Strategy:
397
365
  - Stores: {{TARGET_STORES}}
398
366
  - CI/CD: {{CICD_PIPELINE}}
@@ -407,9 +375,7 @@ Generated Documents:
407
375
  ✅ specs/build-configuration.md
408
376
  ✅ specs/deployment.md
409
377
  ✅ .env.example
410
-
411
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
412
-
378
+ ---
413
379
  📊 Progress Summary:
414
380
 
415
381
  Phases 1-7 completed:
@@ -426,11 +392,9 @@ Phases 1-7 completed:
426
392
 
427
393
  Remaining:
428
394
  ⏭️ Phase 8: Project setup & final documentation
429
-
430
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
395
+ ---
431
396
  🎯 Next: Phase 8 - Project Setup & Final Documentation
432
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
433
-
397
+ ---
434
398
  Phase 8 will:
435
399
  - 🔍 Detect project state (new vs existing)
436
400
  - 🚀 Initialize framework (optional, for new projects)
@@ -441,9 +405,11 @@ Phase 8 will:
441
405
 
442
406
  Continue to Phase 8? (yes/no)
443
407
  ```
444
-
445
- ---
446
-
408
+ ---
447
409
  **Last Updated:** 2025-12-09
448
410
 
449
411
  **Version:** 2.0.0 (Unified workflow with Phase 8)
412
+
413
+
414
+
415
+
@@ -5,9 +5,7 @@
5
5
  **Duration:** 10-15 minutes
6
6
 
7
7
  **Goal:** Set up the project structure and create comprehensive documentation that consolidates all information from previous phases.
8
-
9
- ---
10
-
8
+ ---
11
9
  ## 📋 Phase 8 Overview
12
10
 
13
11
  This final phase will:
@@ -18,9 +16,7 @@ This final phase will:
18
16
  4. **Generate master index** (AGENT.md)
19
17
  5. **Generate README.md** (with intelligent merge if needed)
20
18
  6. **Create tool-specific configs** (based on AI tool selection)
21
-
22
- ---
23
-
19
+ ---
24
20
  ## 8.1: Project State Detection
25
21
 
26
22
  ```
@@ -56,9 +52,7 @@ Found:
56
52
 
57
53
  Recommendation: [Next action based on state]
58
54
  ```
59
-
60
- ---
61
-
55
+ ---
62
56
  ## 8.2: Framework Initialization (Optional)
63
57
 
64
58
  **Only if:** Project state = "New Project"
@@ -215,9 +209,7 @@ You can initialize manually later with:
215
209
 
216
210
  Proceeding to documentation generation...
217
211
  ```
218
-
219
- ---
220
-
212
+ ---
221
213
  ## 8.3: Generate Final Documentation
222
214
 
223
215
  ```
@@ -299,9 +291,7 @@ Generating...
299
291
  ```
300
292
  ✅ Generated: docs/contributing.md
301
293
  ```
302
-
303
- ---
304
-
294
+ ---
305
295
  ## 8.3.4: Generate .gitignore
306
296
 
307
297
  **IMPORTANT:** Generate a comprehensive `.gitignore` file based on the mobile framework selected in previous phases.
@@ -458,9 +448,7 @@ Thumbs.db
458
448
  ✅ Generated: .gitignore
459
449
  Patterns included: [React Native | Flutter] + Platform-specific
460
450
  ```
461
-
462
- ---
463
-
451
+ ---
464
452
  ## 8.4: Generate AGENT.md (Master Index)
465
453
 
466
454
  - **Template:** `.ai-flow/templates/AGENT.template.md`
@@ -545,9 +533,7 @@ Thumbs.db
545
533
  ```
546
534
  ✅ Generated: .ai-flow/AGENT.md (Master Index)
547
535
  ```
548
-
549
- ---
550
-
536
+ ---
551
537
  ## 8.5: Generate README.md (Intelligent Merge)
552
538
 
553
539
  - **Template:** `.ai-flow/templates/README.template.md`
@@ -590,9 +576,7 @@ Thumbs.db
590
576
  ✅ Generated: .ai-flow/README.md
591
577
  [If merged] Merged with framework's setup instructions
592
578
  ```
593
-
594
- ---
595
-
579
+ ---
596
580
  ## 8.6: Create Tool-Specific Configs
597
581
 
598
582
  **Based on AI tool selection from Phase 1:**
@@ -706,9 +690,7 @@ Master index: `.ai-flow/AGENT.md`
706
690
  ✅ Generated tool-specific configs:
707
691
  [List generated files based on selection]
708
692
  ```
709
-
710
- ---
711
-
693
+ ---
712
694
  ## 8.7: Final Validation & Success Message
713
695
 
714
696
  ```
@@ -767,9 +749,7 @@ Phase 8:
767
749
 
768
750
  Tool-specific configs:
769
751
  ✅ [List generated configs]
770
-
771
- ---
772
-
752
+ ---
773
753
  📁 Project Structure:
774
754
 
775
755
  your-app/
@@ -797,9 +777,7 @@ your-app/
797
777
  ├── .env.example
798
778
  ├── .gitignore
799
779
  └── [tool configs] # .clauderules, .cursorrules, etc.
800
-
801
- ---
802
-
780
+ ---
803
781
  Next steps:
804
782
 
805
783
  1. ⭐ **Read `.ai-flow/AGENT.md`** - Master index of all documentation
@@ -817,9 +795,7 @@ Next steps:
817
795
  • Android: `npm run android` or `flutter run`
818
796
  6. 💾 **Initialize git** (if not done) - `git init && git add . && git commit -m "Initial commit with AI Flow docs"`
819
797
  7. 🧪 **Start developing!** - Your AI assistant now has complete project context
820
-
821
- ---
822
-
798
+ ---
823
799
  💡 **Remember:**
824
800
  - Documents are **living artifacts** - update them as project evolves
825
801
  - All AI assistants will reference these docs for future work
@@ -836,9 +812,7 @@ Your AI assistant (Claude, Cursor, Copilot) will now:
836
812
 
837
813
  Happy building! 🎉📱
838
814
  ```
839
-
840
- ---
841
-
815
+ ---
842
816
  ## EXECUTION CHECKLIST FOR AI ASSISTANT
843
817
 
844
818
  When executing Phase 8:
@@ -894,9 +868,10 @@ When executing Phase 8:
894
868
  - [ ] Show success message
895
869
 
896
870
  **ESTIMATED TIME:** 10-15 minutes
897
-
898
- ---
899
-
871
+ ---
900
872
  **CONTINUE TO:** End (Phase 8 is final phase)
901
873
 
902
874
  **SUCCESS:** Mobile app fully documented and ready for development! 🚀📱
875
+
876
+
877
+
@@ -3,9 +3,7 @@
3
3
  **YOU ARE AN EXPERT MOBILE ARCHITECT AND DOCUMENTATION SPECIALIST.**
4
4
 
5
5
  Your mission is to guide the user through creating **comprehensive, production-ready documentation** for their mobile application through an interactive questionnaire that follows the dependency-aware order specified below.
6
-
7
- ---
8
-
6
+ ---
9
7
  ## 🎯 Ejecución de Fase Específica
10
8
 
11
9
  **IMPORTANTE:** Detectar si el usuario especificó una fase para ejecutar.
@@ -56,11 +54,9 @@ Si el usuario especifica una fase inválida, mostrar:
56
54
 
57
55
  ```
58
56
  ❌ Fase inválida. Las fases válidas para mobile son:
59
-
60
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
57
+ ---
61
58
  📋 Fases Disponibles - Mobile
62
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
63
-
59
+ ---
64
60
  /flow-build fase 0 - Context Discovery (solo proyectos existentes)
65
61
  /flow-build fase 1 - Platform & Framework (iOS/Android, React Native/Flutter)
66
62
  /flow-build fase 2 - Navigation & Architecture (navegación, estructura)
@@ -70,14 +66,10 @@ Si el usuario especifica una fase inválida, mostrar:
70
66
  /flow-build fase 6 - Testing Strategy (tipos de tests, coverage, CI)
71
67
  /flow-build fase 7 - Store Deployment (App Store, Play Store, signing)
72
68
  /flow-build fase 8 - Project Setup & Final Documentation (inicializar proyecto)
73
-
74
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
75
-
69
+ ---
76
70
  💡 Tip: Usa /flow-build sin argumentos para ejecutar todas las fases en orden.
77
71
  ```
78
-
79
- ---
80
-
72
+ ---
81
73
  ## Important Instructions
82
74
 
83
75
  1. **Ask for Project Scope FIRST** - Before Phase 1, ask the user to select: MVP, Production-Ready, or Enterprise
@@ -86,15 +78,15 @@ Si el usuario especifica una fase inválida, mostrar:
86
78
  4. **Ask questions ONE BY ONE** - Do not present multiple questions at once. Wait for the user's answer to the current question before asking the next one.
87
79
  5. **Show progress indicator before EVERY question** - Use this format:
88
80
  ```
89
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
81
+ ---
90
82
  📋 Phase [N]: [Phase Name] | Question [X]/[Total] | Phase Progress: [%]%
91
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
83
+ ---
92
84
  ```
93
85
  Example for Phase 2, Question 5 of 12:
94
86
  ```
95
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
87
+ ---
96
88
  📋 Phase 2: Navigation & Architecture | Question 5/12 | Phase Progress: 42%
97
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
89
+ ---
98
90
  ```
99
91
  6. **Provide recommendations** using these markers:
100
92
  - ⭐ **Recommended** - Best choice for most projects
@@ -104,9 +96,7 @@ Si el usuario especifica una fase inválida, mostrar:
104
96
  7. **Use multiple choice when possible** - Give 3-5 options (A, B, C, D, E)
105
97
  8. **Validate completeness** - Ensure all critical information is gathered
106
98
  9. **Generate documents incrementally** - After each phase, generate corresponding documents with validation
107
-
108
- ---
109
-
99
+ ---
110
100
  ## 📚 How to Use This Guide
111
101
 
112
102
  This documentation is **modularized** for better maintainability and performance. Each phase is in a separate file.
@@ -132,9 +122,7 @@ You can execute any phase independently by reading its file. For example:
132
122
  ```
133
123
  Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase 3
134
124
  ```
135
-
136
- ---
137
-
125
+ ---
138
126
  ## 🎯 Phase Overview
139
127
 
140
128
  ### Phase 0: Context Discovery (Optional)
@@ -154,9 +142,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
154
142
  **Supports:** React Native, Flutter, Native iOS (Swift), Native Android (Kotlin), Ionic, Xamarin
155
143
 
156
144
  **Skip if:** Starting a completely new project from scratch
157
-
158
- ---
159
-
145
+ ---
160
146
  ### Phase 1: Platform & Framework Selection
161
147
 
162
148
  **File:** `mobile/flow-build-phase-1-platform.md`
@@ -177,9 +163,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
177
163
  - `project-brief.md`
178
164
  - Parts of `AGENT.md`
179
165
  - Parts of `ai-instructions.md`
180
-
181
- ---
182
-
166
+ ---
183
167
  ### Phase 2: Navigation & Architecture
184
168
 
185
169
  **File:** `mobile/flow-build-phase-2-navigation.md`
@@ -196,9 +180,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
196
180
  - `docs/navigation.md`
197
181
  - `docs/architecture.md`
198
182
  - Parts of `ai-instructions.md`
199
-
200
- ---
201
-
183
+ ---
202
184
  ### Phase 3: State & Data Management
203
185
 
204
186
  **File:** `mobile/flow-build-phase-3-state.md`
@@ -215,9 +197,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
215
197
  - `docs/state-management.md`
216
198
  - `docs/offline-strategy.md`
217
199
  - Parts of `ai-instructions.md`
218
-
219
- ---
220
-
200
+ ---
221
201
  ### Phase 4: Permissions & Native Features
222
202
 
223
203
  **File:** `mobile/flow-build-phase-4-permissions.md`
@@ -234,9 +214,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
234
214
  - `docs/permissions.md`
235
215
  - `docs/native-features.md`
236
216
  - Parts of `ai-instructions.md`
237
-
238
- ---
239
-
217
+ ---
240
218
  ### Phase 5: Code Standards & Best Practices
241
219
 
242
220
  **File:** `mobile/flow-build-phase-5-standards.md`
@@ -252,9 +230,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
252
230
 
253
231
  - `docs/code-standards.md`
254
232
  - Parts of `ai-instructions.md`
255
-
256
- ---
257
-
233
+ ---
258
234
  ### Phase 6: Testing Strategy
259
235
 
260
236
  **File:** `mobile/flow-build-phase-6-testing.md`
@@ -271,9 +247,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
271
247
 
272
248
  - `docs/testing.md`
273
249
  - Parts of `ai-instructions.md`
274
-
275
- ---
276
-
250
+ ---
277
251
  ### Phase 7: Store Deployment
278
252
 
279
253
  **File:** `mobile/flow-build-phase-7-deployment.md`
@@ -294,9 +268,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
294
268
  - `.env.example`
295
269
 
296
270
  **Next:** Transitions to Phase 8 for project setup and final documentation
297
-
298
- ---
299
-
271
+ ---
300
272
  ### Phase 8: Project Setup & Final Documentation
301
273
 
302
274
  **File:** `mobile/flow-build-phase-8.md`
@@ -317,9 +289,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
317
289
  - `AGENT.md` (master index)
318
290
  - `README.md`
319
291
  - Tool-specific configs (`.clauderules`, `.cursorrules`, `.github/copilot-instructions.md`)
320
-
321
- ---
322
-
292
+ ---
323
293
  ## 📊 Scope-Based Question Filtering
324
294
 
325
295
  ### MVP Scope (60-80 minutes)
@@ -337,9 +307,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
337
307
  - Manual deployment
338
308
 
339
309
  **Best for:** Prototypes, MVPs, proof of concept
340
-
341
- ---
342
-
310
+ ---
343
311
  ### Production-Ready Scope (100-130 minutes)
344
312
 
345
313
  **Phases included:** All (1-7)
@@ -356,9 +324,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
356
324
  - Store deployment configuration
357
325
 
358
326
  **Best for:** Production applications, client projects, published apps
359
-
360
- ---
361
-
327
+ ---
362
328
  ### Enterprise Scope (130-160 minutes)
363
329
 
364
330
  **Phases included:** All (1-7) with extended questions
@@ -375,9 +341,7 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
375
341
  - A/B testing infrastructure
376
342
 
377
343
  **Best for:** Large-scale applications, enterprise platforms, mission-critical apps
378
-
379
- ---
380
-
344
+ ---
381
345
  ## 🎯 Execution Workflow
382
346
 
383
347
  ### Step 1: Scope Selection
@@ -385,33 +349,23 @@ Read .ai-flow/prompts/mobile/flow-build-phase-3-state.md and execute only Phase
385
349
  **Before Phase 1**, ask:
386
350
 
387
351
  ```
388
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
352
+ ---
389
353
  🎯 Project Scope Selection
390
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
391
-
392
- What scope level do you want for this documentation?
393
-
394
- A) 🚀 **MVP** (60-80 min) - Core features only, minimal setup
395
- - Phases 1-4 (core questions)
396
- - Single platform
397
- - Basic navigation and state
398
- - Minimal testing
399
- - Best for: Prototypes, proof of concept
400
-
401
- B) ⭐ **Production-Ready** (100-130 min) - Complete professional setup
402
- - All phases 1-7
403
- - Multi-platform support
404
- - Full tech stack
405
- - Comprehensive testing
406
- - CI/CD pipeline
407
- - Best for: Production apps, published apps
408
-
409
- C) 🏆 **Enterprise** (130-160 min) - Advanced features and scalability
410
- - All phases with extended questions
411
- - Advanced architecture
412
- - Complex offline sync
413
- - Advanced security
414
- - Best for: Large-scale, mission-critical apps
354
+ ---
355
+ ## 📋 Scope Selection
356
+
357
+ Before starting Phase 1, you'll select a scope level:
358
+
359
+ > 📎 **Reference:** See [prompts/shared/scope-levels.md](../shared/scope-levels.md) for detailed scope definitions (MVP, Production-Ready, Enterprise).
360
+
361
+ ### A) MVP / Prototype
362
+ **Focus:** Core functionality + basic tests. Best for POCs and internal tools.
363
+
364
+ ### B) 🚀 Production-Ready
365
+ **Focus:** Production-grade with best practices. Best for SaaS and customer-facing apps.
366
+
367
+ ### C) 🏢 Enterprise / Mission-Critical
368
+ **Focus:** Enterprise governance, compliance, and high scalability.
415
369
 
416
370
  Your choice (A/B/C):
417
371
  ```
@@ -460,9 +414,7 @@ Before finalizing, validate:
460
414
  4. ✅ Framework-specific examples match selected framework
461
415
  5. ✅ Cross-references between documents are correct
462
416
  6. ✅ Platform-specific considerations documented (iOS vs Android)
463
-
464
- ---
465
-
417
+ ---
466
418
  ## 🔄 Iterative Updates
467
419
 
468
420
  Users can re-run individual phases to update documentation:
@@ -472,9 +424,7 @@ Users can re-run individual phases to update documentation:
472
424
  → Re-execute Phase 3 only
473
425
  → Regenerate docs/state-management.md and parts of ai-instructions.md
474
426
  ```
475
-
476
- ---
477
-
427
+ ---
478
428
  ## 🎨 Framework-Specific Adaptations
479
429
 
480
430
  The questionnaire adapts based on the framework selected in Phase 1:
@@ -506,9 +456,7 @@ The questionnaire adapts based on the framework selected in Phase 1:
506
456
  - Navigation: Navigation Component, Jetpack Compose Navigation
507
457
  - Storage: Room, DataStore, SharedPreferences
508
458
  - Testing: JUnit, Espresso, UI Automator
509
-
510
- ---
511
-
459
+ ---
512
460
  ## 🚀 Getting Started
513
461
 
514
462
  To begin the complete mobile build process:
@@ -530,9 +478,11 @@ Or if you have existing code, start with Phase 0 for automatic detection:
530
478
  ```
531
479
  .ai-flow/prompts/mobile/flow-build-phase-0-context.md
532
480
  ```
533
-
534
- ---
535
-
481
+ ---
536
482
  **Last Updated:** 2025-01-XX
537
483
 
538
484
  **Version:** 1.4.0 (Mobile MVP)
485
+
486
+
487
+
488
+