ai-flow-dev 2.1.3 → 2.1.5

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 +25 -38
  2. package/dist/cli.js +68 -46
  3. package/dist/cli.js.map +1 -1
  4. package/package.json +5 -5
  5. package/prompts/backend/flow-build-phase-0.md +31 -63
  6. package/prompts/backend/flow-build-phase-1.md +9 -17
  7. package/prompts/backend/flow-build-phase-10.md +199 -585
  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 +120 -40
  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 +20 -196
  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 +14 -35
  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 +13 -32
  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:** ~10 questions
5
5
  **Output:** docs/permissions.md, docs/native-features.md, parts of ai-instructions.md
6
-
7
- ---
8
-
6
+ ---
9
7
  ## 🎯 Objective
10
8
 
11
9
  Define what **native features and permissions** your app will use:
@@ -14,9 +12,7 @@ Define what **native features and permissions** your app will use:
14
12
  2. What native features will you integrate?
15
13
  3. How will you handle permission requests?
16
14
  4. What third-party SDKs will you use?
17
-
18
- ---
19
-
15
+ ---
20
16
  ## 📋 Questions
21
17
 
22
18
  ### Question 4.1: Camera Permission
@@ -24,302 +20,320 @@ Define what **native features and permissions** your app will use:
24
20
  **Will your app use the camera?**
25
21
 
26
22
  A) ⭐ **Yes - Photo Capture**
27
- - Take photos within app
28
- - Requires: Camera permission
29
- - Best for: Social apps, productivity apps
23
+
24
+ - Take photos within app
25
+ - Requires: Camera permission
26
+ - Best for: Social apps, productivity apps
30
27
 
31
28
  B) **Yes - Video Recording**
32
- - Record videos
33
- - Requires: Camera + Microphone permissions
34
- - Best for: Video apps, social media
29
+
30
+ - Record videos
31
+ - Requires: Camera + Microphone permissions
32
+ - Best for: Video apps, social media
35
33
 
36
34
  C) **Yes - QR Code Scanning**
37
- - Scan QR codes
38
- - Requires: Camera permission
39
- - Best for: Payment apps, utilities
35
+
36
+ - Scan QR codes
37
+ - Requires: Camera permission
38
+ - Best for: Payment apps, utilities
40
39
 
41
40
  D) **No Camera Access**
42
- - No camera features
43
- - Best for: Most apps
41
+
42
+ - No camera features
43
+ - Best for: Most apps
44
44
 
45
45
  **Your answer:**
46
46
 
47
47
  **If camera selected, ask:**
48
+
48
49
  - What library will you use?
49
50
  - React Native: react-native-camera, react-native-vision-camera
50
51
  - Flutter: camera, image_picker
51
52
  - Native: AVFoundation (iOS), Camera2 (Android)
52
-
53
- ---
54
-
53
+ ---
55
54
  ### Question 4.2: Location Permission
56
55
 
57
56
  **Will your app use location services?**
58
57
 
59
58
  A) ⭐ **Yes - When In Use** (Recommended)
60
- - Location only when app is active
61
- - Requires: Location When In Use permission
62
- - Best for: Most location-based apps
59
+
60
+ - Location only when app is active
61
+ - Requires: Location When In Use permission
62
+ - Best for: Most location-based apps
63
63
 
64
64
  B) **Yes - Always**
65
- - Location even when app is backgrounded
66
- - Requires: Always permission (harder to get approved)
67
- - Best for: Navigation, fitness tracking
65
+
66
+ - Location even when app is backgrounded
67
+ - Requires: Always permission (harder to get approved)
68
+ - Best for: Navigation, fitness tracking
68
69
 
69
70
  C) **Yes - Approximate Location**
70
- - Approximate location only (less privacy-invasive)
71
- - Best for: Location-based content
71
+
72
+ - Approximate location only (less privacy-invasive)
73
+ - Best for: Location-based content
72
74
 
73
75
  D) **No Location Access**
74
- - No location features
75
- - Best for: Most apps
76
+
77
+ - No location features
78
+ - Best for: Most apps
76
79
 
77
80
  **Your answer:**
78
81
 
79
82
  **If location selected, ask:**
83
+
80
84
  - What library will you use?
81
85
  - React Native: @react-native-community/geolocation, react-native-maps
82
86
  - Flutter: geolocator, google_maps_flutter
83
87
  - Native: CoreLocation (iOS), Location Services (Android)
84
-
85
- ---
86
-
88
+ ---
87
89
  ### Question 4.3: Push Notifications
88
90
 
89
91
  **Will your app send push notifications?**
90
92
 
91
93
  A) ⭐ **Yes - User Notifications** (Recommended)
92
- - Notify users of important events
93
- - Requires: Notification permission
94
- - Best for: Most apps
94
+
95
+ - Notify users of important events
96
+ - Requires: Notification permission
97
+ - Best for: Most apps
95
98
 
96
99
  B) **Yes - Background Notifications**
97
- - Notify even when app is closed
98
- - Requires: Background modes
99
- - Best for: Real-time apps
100
+
101
+ - Notify even when app is closed
102
+ - Requires: Background modes
103
+ - Best for: Real-time apps
100
104
 
101
105
  C) **No Push Notifications**
102
- - No notifications
103
- - Best for: Simple apps, privacy-focused apps
106
+
107
+ - No notifications
108
+ - Best for: Simple apps, privacy-focused apps
104
109
 
105
110
  **Your answer:**
106
111
 
107
112
  **If notifications selected, ask:**
113
+
108
114
  - What service will you use?
109
115
  - Firebase Cloud Messaging (FCM)
110
116
  - OneSignal
111
117
  - Pusher
112
118
  - Custom backend
113
-
114
- ---
115
-
119
+ ---
116
120
  ### Question 4.4: Photo Library Access
117
121
 
118
122
  **Will your app access the photo library?**
119
123
 
120
124
  A) ⭐ **Yes - Read Only**
121
- - Select photos from library
122
- - Requires: Photo Library Read permission
123
- - Best for: Most apps that need photos
125
+
126
+ - Select photos from library
127
+ - Requires: Photo Library Read permission
128
+ - Best for: Most apps that need photos
124
129
 
125
130
  B) **Yes - Read & Write**
126
- - Save photos to library
127
- - Requires: Photo Library Write permission
128
- - Best for: Photo editing apps
129
131
 
130
- C) **No Photo Library Access**
131
- - No photo library features
132
- - Best for: Apps that don't need photos
132
+ - Save photos to library
133
+ - Requires: Photo Library Write permission
134
+ - Best for: Photo editing apps
133
135
 
134
- **Your answer:**
136
+ C) **No Photo Library Access**
135
137
 
136
- ---
138
+ - No photo library features
139
+ - Best for: Apps that don't need photos
137
140
 
141
+ **Your answer:**
142
+ ---
138
143
  ### Question 4.5: Contacts Access
139
144
 
140
145
  **Will your app access contacts?**
141
146
 
142
147
  A) ⭐ **Yes - Read Contacts**
143
- - Import contacts
144
- - Requires: Contacts Read permission
145
- - Best for: Social apps, messaging apps
148
+
149
+ - Import contacts
150
+ - Requires: Contacts Read permission
151
+ - Best for: Social apps, messaging apps
146
152
 
147
153
  B) **Yes - Read & Write**
148
- - Add contacts
149
- - Requires: Contacts Write permission
150
- - Best for: Contact management apps
151
154
 
152
- C) **No Contacts Access**
153
- - No contact features
154
- - Best for: Most apps
155
+ - Add contacts
156
+ - Requires: Contacts Write permission
157
+ - Best for: Contact management apps
155
158
 
156
- **Your answer:**
159
+ C) **No Contacts Access**
157
160
 
158
- ---
161
+ - No contact features
162
+ - Best for: Most apps
159
163
 
164
+ **Your answer:**
165
+ ---
160
166
  ### Question 4.6: Biometric Authentication
161
167
 
162
168
  **Will your app use biometric authentication?**
163
169
 
164
170
  A) ⭐ **Yes - Face ID / Touch ID / Fingerprint** (Recommended)
165
- - Secure authentication
166
- - Requires: Face ID / Touch ID permission
167
- - Best for: Secure apps, banking apps
171
+
172
+ - Secure authentication
173
+ - Requires: Face ID / Touch ID permission
174
+ - Best for: Secure apps, banking apps
168
175
 
169
176
  B) **No Biometric Auth**
170
- - Traditional password/PIN only
171
- - Best for: Simple apps
177
+
178
+ - Traditional password/PIN only
179
+ - Best for: Simple apps
172
180
 
173
181
  **Your answer:**
174
182
 
175
183
  **If biometric selected, ask:**
184
+
176
185
  - What library will you use?
177
186
  - React Native: react-native-biometrics, react-native-touch-id
178
187
  - Flutter: local_auth
179
188
  - Native: LocalAuthentication (iOS), BiometricPrompt (Android)
180
-
181
- ---
182
-
189
+ ---
183
190
  ### Question 4.7: File System Access
184
191
 
185
192
  **Will your app access the file system?**
186
193
 
187
194
  A) ⭐ **Yes - Document Picker**
188
- - Let users select files
189
- - Requires: File access permission
190
- - Best for: Document apps, file managers
195
+
196
+ - Let users select files
197
+ - Requires: File access permission
198
+ - Best for: Document apps, file managers
191
199
 
192
200
  B) **Yes - File Storage**
193
- - Save files to device
194
- - Requires: Storage permission
195
- - Best for: File management apps
196
201
 
197
- C) **No File System Access**
198
- - No file features
199
- - Best for: Most apps
202
+ - Save files to device
203
+ - Requires: Storage permission
204
+ - Best for: File management apps
200
205
 
201
- **Your answer:**
206
+ C) **No File System Access**
202
207
 
203
- ---
208
+ - No file features
209
+ - Best for: Most apps
204
210
 
211
+ **Your answer:**
212
+ ---
205
213
  ### Question 4.8: Microphone Access
206
214
 
207
215
  **Will your app use the microphone?**
208
216
 
209
217
  A) ⭐ **Yes - Audio Recording**
210
- - Record audio
211
- - Requires: Microphone permission
212
- - Best for: Voice notes, recording apps
218
+
219
+ - Record audio
220
+ - Requires: Microphone permission
221
+ - Best for: Voice notes, recording apps
213
222
 
214
223
  B) **Yes - Voice Calls**
215
- - Make voice/video calls
216
- - Requires: Microphone permission
217
- - Best for: Communication apps
218
224
 
219
- C) **No Microphone Access**
220
- - No audio recording
221
- - Best for: Most apps
225
+ - Make voice/video calls
226
+ - Requires: Microphone permission
227
+ - Best for: Communication apps
222
228
 
223
- **Your answer:**
229
+ C) **No Microphone Access**
224
230
 
225
- ---
231
+ - No audio recording
232
+ - Best for: Most apps
226
233
 
234
+ **Your answer:**
235
+ ---
227
236
  ### Question 4.9: Third-Party SDKs
228
237
 
229
238
  **What third-party SDKs will you integrate?**
230
239
 
231
240
  **Analytics:**
241
+
232
242
  - A) Firebase Analytics
233
243
  - B) Mixpanel
234
244
  - C) Amplitude
235
245
  - D) None
236
246
 
237
247
  **Crash Reporting:**
248
+
238
249
  - A) Firebase Crashlytics
239
250
  - B) Sentry
240
251
  - C) Bugsnag
241
252
  - D) None
242
253
 
243
254
  **Authentication:**
255
+
244
256
  - A) Firebase Auth
245
257
  - B) Auth0
246
258
  - C) AWS Cognito
247
259
  - D) Custom backend
248
260
 
249
261
  **Maps:**
262
+
250
263
  - A) Google Maps
251
264
  - B) Mapbox
252
265
  - C) Apple Maps (iOS only)
253
266
  - D) None
254
267
 
255
268
  **Payments:**
269
+
256
270
  - A) Stripe
257
271
  - B) PayPal
258
272
  - C) Apple Pay / Google Pay
259
273
  - D) None
260
274
 
261
275
  **Social Login:**
276
+
262
277
  - A) Firebase Auth (Google, Facebook, Apple)
263
278
  - B) Auth0 Social Connections
264
279
  - C) Custom OAuth
265
280
  - D) None
266
281
 
267
282
  **Your answer:** (Select all that apply)
268
-
269
- ---
270
-
283
+ ---
271
284
  ### Question 4.10: Permission Request Strategy
272
285
 
273
286
  **How will you request permissions?**
274
287
 
275
288
  A) ⭐ **Just-In-Time** (Recommended)
276
- - Request when feature is needed
277
- - Explain why permission is needed
278
- - Best for: Better user experience
289
+
290
+ - Request when feature is needed
291
+ - Explain why permission is needed
292
+ - Best for: Better user experience
279
293
 
280
294
  B) **On First Launch**
281
- - Request all permissions upfront
282
- - Less ideal (can overwhelm users)
283
- - Best for: Apps that need all permissions
284
295
 
285
- C) **Progressive**
286
- - Request permissions as features are discovered
287
- - Best for: Apps with optional features
296
+ - Request all permissions upfront
297
+ - Less ideal (can overwhelm users)
298
+ - Best for: Apps that need all permissions
288
299
 
289
- **Your answer:**
300
+ C) **Progressive**
290
301
 
291
- ---
302
+ - Request permissions as features are discovered
303
+ - Best for: Apps with optional features
292
304
 
305
+ **Your answer:**
306
+ ---
293
307
  ### Question 4.11: Permission Denial Handling
294
308
 
295
309
  **How will you handle denied permissions?**
296
310
 
297
311
  A) ⭐ **Graceful Degradation** (Recommended)
298
- - App works without permission
299
- - Show alternative options
300
- - Best for: Better UX
312
+
313
+ - App works without permission
314
+ - Show alternative options
315
+ - Best for: Better UX
301
316
 
302
317
  B) **Show Settings Prompt**
303
- - Guide user to enable in settings
304
- - Best for: Critical permissions
305
318
 
306
- C) **Block Feature**
307
- - Feature unavailable if permission denied
308
- - Best for: Core features
319
+ - Guide user to enable in settings
320
+ - Best for: Critical permissions
309
321
 
310
- **Your answer:**
322
+ C) **Block Feature**
311
323
 
312
- ---
324
+ - Feature unavailable if permission denied
325
+ - Best for: Core features
313
326
 
327
+ **Your answer:**
328
+ ---
314
329
  ## ✅ Phase 4 Completion
315
330
 
316
331
  After answering all questions, summarize:
317
332
 
318
333
  ```
319
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
334
+ ---
320
335
  ✅ Phase 4 Complete: Permissions & Native Features
321
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
322
-
336
+ ---
323
337
  Selected Permissions:
324
338
  - Camera: Photo capture (react-native-vision-camera)
325
339
  - Location: When in use (@react-native-community/geolocation)
@@ -337,9 +351,7 @@ Permission Strategy: Just-In-Time requests with graceful degradation
337
351
 
338
352
  Proceed to Phase 5 (Code Standards)? (Y/n)
339
353
  ```
340
-
341
- ---
342
-
354
+ ---
343
355
  ## 📝 Generated Documents
344
356
 
345
357
  After Phase 4, generate/update:
@@ -347,15 +359,11 @@ After Phase 4, generate/update:
347
359
  - `docs/permissions.md` - Permission handling guide
348
360
  - `docs/native-features.md` - Native features integration guide
349
361
  - `ai-instructions.md` - Add permission and native feature rules
350
-
351
- ---
352
-
362
+ ---
353
363
  **Next Phase:** Phase 5 - Code Standards
354
364
 
355
365
  Read: `.ai-flow/prompts/mobile/flow-build-phase-5-standards.md`
356
-
357
- ---
358
-
366
+ ---
359
367
  **Last Updated:** 2025-01-XX
360
368
 
361
369
  **Version:** 1.4.0