ai-flow-dev 1.0.3 → 1.1.1

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 (40) hide show
  1. package/README.md +60 -35
  2. package/dist/cli.js +201 -232
  3. package/dist/cli.js.map +1 -1
  4. package/dist/fs-utils.js +3 -39
  5. package/dist/fs-utils.js.map +1 -1
  6. package/package.json +11 -12
  7. package/prompts/backend/{flow-docs-gen-phase-7.md → flow-bootstrap-phase-7.md} +41 -108
  8. package/prompts/backend/flow-bootstrap-phase-8.md +911 -0
  9. package/prompts/backend/{flow-project-roadmap.md → flow-bootstrap-phase-9.md} +255 -344
  10. package/prompts/backend/{flow-docs-gen.md → flow-bootstrap.md} +102 -37
  11. package/prompts/frontend/{flow-docs-gen-phase-0.md → flow-bootstrap-phase-0.md} +2 -1
  12. package/prompts/frontend/{flow-docs-gen-phase-1.md → flow-bootstrap-phase-1.md} +2 -1
  13. package/prompts/frontend/{flow-docs-gen-phase-3.md → flow-bootstrap-phase-3.md} +2 -1
  14. package/prompts/frontend/{flow-docs-gen-phase-4.md → flow-bootstrap-phase-4.md} +2 -1
  15. package/prompts/frontend/{flow-docs-gen-phase-5.md → flow-bootstrap-phase-5.md} +2 -1
  16. package/prompts/frontend/{flow-docs-gen-phase-6.md → flow-bootstrap-phase-6.md} +2 -1
  17. package/prompts/frontend/{flow-docs-gen-phase-7.md → flow-bootstrap-phase-7.md} +225 -200
  18. package/prompts/frontend/flow-bootstrap-phase-8.md +670 -0
  19. package/prompts/frontend/{flow-docs-gen.md → flow-bootstrap.md} +47 -20
  20. package/prompts/frontend/flow-docs-sync.md +2 -1
  21. package/prompts/mobile/{flow-docs-gen-phase-0.md → flow-bootstrap-phase-0.md} +2 -1
  22. package/prompts/mobile/{flow-docs-gen-phase-1.md → flow-bootstrap-phase-1.md} +2 -1
  23. package/prompts/mobile/{flow-docs-gen-phase-2.md → flow-bootstrap-phase-2.md} +2 -1
  24. package/prompts/mobile/{flow-docs-gen-phase-3.md → flow-bootstrap-phase-3.md} +2 -1
  25. package/prompts/mobile/{flow-docs-gen-phase-4.md → flow-bootstrap-phase-4.md} +2 -1
  26. package/prompts/mobile/{flow-docs-gen-phase-5.md → flow-bootstrap-phase-5.md} +2 -1
  27. package/prompts/mobile/{flow-docs-gen-phase-6.md → flow-bootstrap-phase-6.md} +2 -1
  28. package/prompts/mobile/{flow-docs-gen-phase-7.md → flow-bootstrap-phase-7.md} +174 -132
  29. package/prompts/mobile/flow-bootstrap-phase-8.md +676 -0
  30. package/prompts/mobile/{flow-docs-gen.md → flow-bootstrap.md} +47 -20
  31. package/prompts/mobile/flow-docs-sync.md +2 -1
  32. package/prompts/backend/flow-project-init.md +0 -332
  33. /package/prompts/backend/{flow-docs-gen-phase-0.md → flow-bootstrap-phase-0.md} +0 -0
  34. /package/prompts/backend/{flow-docs-gen-phase-1.md → flow-bootstrap-phase-1.md} +0 -0
  35. /package/prompts/backend/{flow-docs-gen-phase-2.md → flow-bootstrap-phase-2.md} +0 -0
  36. /package/prompts/backend/{flow-docs-gen-phase-3.md → flow-bootstrap-phase-3.md} +0 -0
  37. /package/prompts/backend/{flow-docs-gen-phase-4.md → flow-bootstrap-phase-4.md} +0 -0
  38. /package/prompts/backend/{flow-docs-gen-phase-5.md → flow-bootstrap-phase-5.md} +0 -0
  39. /package/prompts/backend/{flow-docs-gen-phase-6.md → flow-bootstrap-phase-6.md} +0 -0
  40. /package/prompts/frontend/{flow-docs-gen-phase-2.md → flow-bootstrap-phase-2.md} +0 -0
@@ -25,23 +25,27 @@ Define your app store deployment strategy:
25
25
  **Which app stores will you publish to?**
26
26
 
27
27
  A) ⭐ **Apple App Store (iOS)** (Required for iOS)
28
- - Requires: Apple Developer Account ($99/year)
29
- - Review process: 1-3 days typically
30
- - Best for: iOS apps
28
+
29
+ - Requires: Apple Developer Account ($99/year)
30
+ - Review process: 1-3 days typically
31
+ - Best for: iOS apps
31
32
 
32
33
  B) ⭐ **Google Play Store (Android)** (Required for Android)
33
- - Requires: Google Play Developer Account ($25 one-time)
34
- - Review process: Usually instant, can take hours
35
- - Best for: Android apps
34
+
35
+ - Requires: Google Play Developer Account ($25 one-time)
36
+ - Review process: Usually instant, can take hours
37
+ - Best for: Android apps
36
38
 
37
39
  C) 🔥 **Both App Store + Play Store** (Recommended for cross-platform)
38
- - Maximum reach
39
- - Best for: Most apps
40
+
41
+ - Maximum reach
42
+ - Best for: Most apps
40
43
 
41
44
  D) **Enterprise Distribution Only**
42
- - Internal distribution
43
- - No public store
44
- - Best for: Enterprise apps
45
+
46
+ - Internal distribution
47
+ - No public store
48
+ - Best for: Enterprise apps
45
49
 
46
50
  **Your answer:**
47
51
 
@@ -52,29 +56,34 @@ D) **Enterprise Distribution Only**
52
56
  **What CI/CD tool will you use for builds and deployment?**
53
57
 
54
58
  A) ⭐ **Fastlane** (Recommended)
55
- - Automates builds, screenshots, deployment
56
- - Works with iOS and Android
57
- - Integrates with GitHub Actions, Bitrise, etc.
58
- - Best for: Most projects
59
+
60
+ - Automates builds, screenshots, deployment
61
+ - Works with iOS and Android
62
+ - Integrates with GitHub Actions, Bitrise, etc.
63
+ - Best for: Most projects
59
64
 
60
65
  B) **Codemagic**
61
- - Cloud-based CI/CD for Flutter/React Native
62
- - Easy setup, good for small teams
63
- - Best for: Flutter/React Native apps
66
+
67
+ - Cloud-based CI/CD for Flutter/React Native
68
+ - Easy setup, good for small teams
69
+ - Best for: Flutter/React Native apps
64
70
 
65
71
  C) **GitHub Actions**
66
- - Flexible, free for public repos
67
- - Custom workflows
68
- - Best for: GitHub-hosted projects
72
+
73
+ - Flexible, free for public repos
74
+ - Custom workflows
75
+ - Best for: GitHub-hosted projects
69
76
 
70
77
  D) **Bitrise**
71
- - Mobile-focused CI/CD
72
- - Good for complex workflows
73
- - Best for: Enterprise teams
78
+
79
+ - Mobile-focused CI/CD
80
+ - Good for complex workflows
81
+ - Best for: Enterprise teams
74
82
 
75
83
  E) **Manual Builds**
76
- - Build locally, upload manually
77
- - Best for: Learning, small projects
84
+
85
+ - Build locally, upload manually
86
+ - Best for: Learning, small projects
78
87
 
79
88
  **Your answer:**
80
89
 
@@ -85,27 +94,32 @@ E) **Manual Builds**
85
94
  **How will you version your app?**
86
95
 
87
96
  A) ⭐ **Semantic Versioning** (Recommended)
88
- - Format: `MAJOR.MINOR.PATCH` (e.g., `1.2.3`)
89
- - MAJOR: Breaking changes
90
- - MINOR: New features, backward compatible
91
- - PATCH: Bug fixes
92
- - Best for: Most apps
97
+
98
+ - Format: `MAJOR.MINOR.PATCH` (e.g., `1.2.3`)
99
+ - MAJOR: Breaking changes
100
+ - MINOR: New features, backward compatible
101
+ - PATCH: Bug fixes
102
+ - Best for: Most apps
93
103
 
94
104
  B) **Date-based Versioning**
95
- - Format: `YYYY.MM.DD` (e.g., `2025.01.20`)
96
- - Best for: Frequent releases
105
+
106
+ - Format: `YYYY.MM.DD` (e.g., `2025.01.20`)
107
+ - Best for: Frequent releases
97
108
 
98
109
  C) **Build Number Only**
99
- - Incrementing build number
100
- - Best for: Simple apps
110
+
111
+ - Incrementing build number
112
+ - Best for: Simple apps
101
113
 
102
114
  **Your answer:**
103
115
 
104
116
  **Version code strategy (Android):**
117
+
105
118
  - A) ⭐ **Incrementing integer** (1, 2, 3, ...)
106
119
  - B) **Based on version** (e.g., 1.2.3 → 10203)
107
120
 
108
121
  **Build number strategy (iOS):**
122
+
109
123
  - A) ⭐ **Incrementing integer** (1, 2, 3, ...)
110
124
  - B) **Based on version** (e.g., 1.2.3 → 10203)
111
125
 
@@ -116,7 +130,9 @@ C) **Build Number Only**
116
130
  **How will you handle code signing?**
117
131
 
118
132
  **For iOS:**
133
+
119
134
  - A) ⭐ **Automatic Signing** (Recommended)
135
+
120
136
  - Xcode manages certificates
121
137
  - Easier for most developers
122
138
  - Best for: Most apps
@@ -127,7 +143,9 @@ C) **Build Number Only**
127
143
  - Best for: Advanced scenarios
128
144
 
129
145
  **For Android:**
146
+
130
147
  - A) ⭐ **Automatic Signing** (Recommended)
148
+
131
149
  - Gradle manages keystores
132
150
  - Easier for most developers
133
151
  - Best for: Most apps
@@ -140,7 +158,9 @@ C) **Build Number Only**
140
158
  **Your answer:**
141
159
 
142
160
  **Keystore management:**
161
+
143
162
  - A) ⭐ **Store in CI/CD secrets** (Recommended)
163
+
144
164
  - GitHub Secrets, Bitrise Secrets, etc.
145
165
  - Secure, automated
146
166
 
@@ -155,27 +175,32 @@ C) **Build Number Only**
155
175
  **How will you handle beta testing?**
156
176
 
157
177
  A) ⭐ **TestFlight (iOS) + Firebase App Distribution (Android)** (Recommended)
158
- - Free, easy to use
159
- - TestFlight: Up to 10,000 testers
160
- - Firebase: Unlimited testers
161
- - Best for: Most projects
178
+
179
+ - Free, easy to use
180
+ - TestFlight: Up to 10,000 testers
181
+ - Firebase: Unlimited testers
182
+ - Best for: Most projects
162
183
 
163
184
  B) **TestFlight (iOS) + Google Play Internal Testing (Android)**
164
- - Official store channels
165
- - Internal testing: Up to 100 testers
166
- - Best for: Store-focused testing
185
+
186
+ - Official store channels
187
+ - Internal testing: Up to 100 testers
188
+ - Best for: Store-focused testing
167
189
 
168
190
  C) **TestFlight (iOS) + Google Play Closed Beta (Android)**
169
- - Closed beta: Up to 20,000 testers
170
- - Best for: Larger beta programs
191
+
192
+ - Closed beta: Up to 20,000 testers
193
+ - Best for: Larger beta programs
171
194
 
172
195
  D) **HockeyApp / App Center**
173
- - Microsoft's solution
174
- - Good for enterprise
196
+
197
+ - Microsoft's solution
198
+ - Good for enterprise
175
199
 
176
200
  E) **No Beta Testing**
177
- - Direct to production
178
- - Best for: MVPs, internal apps
201
+
202
+ - Direct to production
203
+ - Best for: MVPs, internal apps
179
204
 
180
205
  **Your answer:**
181
206
 
@@ -186,18 +211,21 @@ E) **No Beta Testing**
186
211
  **What release strategy will you use?**
187
212
 
188
213
  A) ⭐ **Staged Rollout** (Recommended)
189
- - Release to 10% → 50% → 100% of users
190
- - Monitor for issues before full release
191
- - Best for: Most apps
214
+
215
+ - Release to 10% 50% → 100% of users
216
+ - Monitor for issues before full release
217
+ - Best for: Most apps
192
218
 
193
219
  B) **Gradual Rollout**
194
- - Release to specific countries/regions first
195
- - Expand gradually
196
- - Best for: Global apps
220
+
221
+ - Release to specific countries/regions first
222
+ - Expand gradually
223
+ - Best for: Global apps
197
224
 
198
225
  C) **Full Release**
199
- - Release to 100% immediately
200
- - Best for: Small updates, bug fixes
226
+
227
+ - Release to 100% immediately
228
+ - Best for: Small updates, bug fixes
201
229
 
202
230
  **Your answer:**
203
231
 
@@ -208,6 +236,7 @@ C) **Full Release**
208
236
  **What metadata will you prepare for stores?**
209
237
 
210
238
  **Required:**
239
+
211
240
  - [ ] App name (30 chars iOS, 50 chars Android)
212
241
  - [ ] App description (4000 chars)
213
242
  - [ ] Screenshots (various sizes)
@@ -215,6 +244,7 @@ C) **Full Release**
215
244
  - [ ] Privacy policy URL
216
245
 
217
246
  **Optional:**
247
+
218
248
  - [ ] Promotional text
219
249
  - [ ] Keywords (iOS only)
220
250
  - [ ] App preview videos
@@ -229,17 +259,20 @@ C) **Full Release**
229
259
  **Will you automate screenshot generation?**
230
260
 
231
261
  A) ⭐ **Yes - Fastlane Screenshots** (Recommended)
232
- - Automate screenshots for all devices
233
- - Update automatically on each release
234
- - Best for: Most apps
262
+
263
+ - Automate screenshots for all devices
264
+ - Update automatically on each release
265
+ - Best for: Most apps
235
266
 
236
267
  B) **Yes - Manual Scripts**
237
- - Custom screenshot scripts
238
- - Best for: Custom requirements
268
+
269
+ - Custom screenshot scripts
270
+ - Best for: Custom requirements
239
271
 
240
272
  C) **No - Manual Screenshots**
241
- - Take screenshots manually
242
- - Best for: Small teams, infrequent updates
273
+
274
+ - Take screenshots manually
275
+ - Best for: Small teams, infrequent updates
243
276
 
244
277
  **Your answer:**
245
278
 
@@ -250,6 +283,7 @@ C) **No - Manual Screenshots**
250
283
  **How will you prepare for app review?**
251
284
 
252
285
  **For iOS App Store:**
286
+
253
287
  - [ ] Test on latest iOS version
254
288
  - [ ] Test on multiple device sizes
255
289
  - [ ] Ensure all features work
@@ -258,6 +292,7 @@ C) **No - Manual Screenshots**
258
292
  - [ ] Test in TestFlight first
259
293
 
260
294
  **For Google Play:**
295
+
261
296
  - [ ] Test on latest Android version
262
297
  - [ ] Test on multiple device sizes
263
298
  - [ ] Ensure all features work
@@ -274,20 +309,24 @@ C) **No - Manual Screenshots**
274
309
  **How often will you release updates?**
275
310
 
276
311
  A) ⭐ **As Needed** (Recommended)
277
- - Release when features are ready
278
- - Best for: Most apps
312
+
313
+ - Release when features are ready
314
+ - Best for: Most apps
279
315
 
280
316
  B) **Weekly**
281
- - Regular weekly releases
282
- - Best for: Rapid iteration
317
+
318
+ - Regular weekly releases
319
+ - Best for: Rapid iteration
283
320
 
284
321
  C) **Bi-weekly**
285
- - Every two weeks
286
- - Best for: Balanced approach
322
+
323
+ - Every two weeks
324
+ - Best for: Balanced approach
287
325
 
288
326
  D) **Monthly**
289
- - Once per month
290
- - Best for: Stable apps
327
+
328
+ - Once per month
329
+ - Best for: Stable apps
291
330
 
292
331
  **Your answer:**
293
332
 
@@ -298,16 +337,19 @@ D) **Monthly**
298
337
  **How will you handle rollbacks?**
299
338
 
300
339
  A) ⭐ **Store Rollback** (Recommended)
301
- - Revert to previous version in store
302
- - Best for: Critical bugs
340
+
341
+ - Revert to previous version in store
342
+ - Best for: Critical bugs
303
343
 
304
344
  B) **Hotfix Release**
305
- - Release emergency fix
306
- - Best for: Quick fixes
345
+
346
+ - Release emergency fix
347
+ - Best for: Quick fixes
307
348
 
308
349
  C) **No Rollback Plan**
309
- - Not recommended
310
- - Best for: Very small apps
350
+
351
+ - Not recommended
352
+ - Best for: Very small apps
311
353
 
312
354
  **Your answer:**
313
355
 
@@ -318,21 +360,25 @@ C) **No Rollback Plan**
318
360
  **What monitoring will you use post-deployment?**
319
361
 
320
362
  A) ⭐ **Firebase Analytics + Crashlytics** (Recommended)
321
- - Free, comprehensive
322
- - Works with iOS and Android
323
- - Best for: Most apps
363
+
364
+ - Free, comprehensive
365
+ - Works with iOS and Android
366
+ - Best for: Most apps
324
367
 
325
368
  B) **Sentry**
326
- - Excellent error tracking
327
- - Good for: Production apps
369
+
370
+ - Excellent error tracking
371
+ - Good for: Production apps
328
372
 
329
373
  C) **App Store Connect Analytics + Play Console Analytics**
330
- - Built-in store analytics
331
- - Best for: Store metrics
374
+
375
+ - Built-in store analytics
376
+ - Best for: Store metrics
332
377
 
333
378
  D) **Custom Analytics**
334
- - Mixpanel, Amplitude, etc.
335
- - Best for: Advanced analytics
379
+
380
+ - Mixpanel, Amplitude, etc.
381
+ - Best for: Advanced analytics
336
382
 
337
383
  **Your answer:**
338
384
 
@@ -348,60 +394,56 @@ After answering all questions, summarize:
348
394
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
349
395
 
350
396
  Selected Deployment Strategy:
351
- - Stores: App Store + Play Store
352
- - CI/CD: Fastlane + GitHub Actions
353
- - Versioning: Semantic Versioning
354
- - Code Signing: Automatic
355
- - Beta Testing: TestFlight + Firebase App Distribution
356
- - Release Strategy: Staged Rollout
357
- - Monitoring: Firebase Analytics + Crashlytics
358
-
359
- All phases complete! Ready to generate documentation.
360
- ```
361
-
362
- ---
363
-
364
- ## 📝 Generated Documents
365
-
366
- After Phase 7, generate/update:
397
+ - Stores: {{TARGET_STORES}}
398
+ - CI/CD: {{CICD_PIPELINE}}
399
+ - Versioning: {{VERSIONING_STRATEGY}}
400
+ - Code Signing: {{CODE_SIGNING}}
401
+ - Beta Testing: {{BETA_TESTING}}
402
+ - Release Strategy: {{RELEASE_STRATEGY}}
403
+ - Monitoring: {{MONITORING_TOOLS}}
404
+
405
+ Generated Documents:
406
+ ✅ docs/app-store.md
407
+ ✅ specs/build-configuration.md
408
+ ✅ specs/deployment.md
409
+ ✅ .env.example
367
410
 
368
- - `docs/app-store.md` - App Store configuration and deployment guide
369
- - `specs/build-configuration.md` - Build and CI/CD configuration
370
- - `specs/deployment.md` - Deployment procedures
371
- - `ai-instructions.md` - Add deployment rules
411
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
372
412
 
373
- ---
413
+ 📊 Progress Summary:
374
414
 
375
- ## 🎉 Bootstrap Complete!
415
+ Phases 1-7 completed:
416
+ ✅ project-brief.md (Phase 1)
417
+ ✅ docs/app-structure.md (Phase 2)
418
+ ✅ docs/architecture.md (Phase 3)
419
+ ✅ ai-instructions.md (Phase 3)
420
+ ✅ docs/code-standards.md (Phase 5)
421
+ ✅ docs/testing.md (Phase 6)
422
+ ✅ docs/app-store.md (Phase 7)
423
+ ✅ specs/build-configuration.md (Phase 7)
424
+ ✅ specs/deployment.md (Phase 7)
425
+ ✅ .env.example (Phase 7)
376
426
 
377
- All 7 phases are complete. Generate the full documentation set:
427
+ Remaining:
428
+ ⏭️ Phase 8: Project setup & final documentation
378
429
 
379
- **Core Documents:**
380
- - `AGENT.md` - Universal AI assistant configuration
381
- - `ai-instructions.md` - Tech stack and development rules
382
- - `project-brief.md` - Project overview and objectives
383
- - `README.md` - Quick start guide
430
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
431
+ 🎯 Next: Phase 8 - Project Setup & Final Documentation
432
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
384
433
 
385
- **Documentation:**
386
- - `docs/architecture.md` - System architecture
387
- - `docs/navigation.md` - Navigation patterns
388
- - `docs/state-management.md` - State management guide
389
- - `docs/offline-strategy.md` - Offline and sync strategy
390
- - `docs/permissions.md` - Permissions handling
391
- - `docs/native-features.md` - Native features integration
392
- - `docs/code-standards.md` - Code standards
393
- - `docs/testing.md` - Testing strategy
394
- - `docs/app-store.md` - App Store configuration
434
+ Phase 8 will:
435
+ - 🔍 Detect project state (new vs existing)
436
+ - 🚀 Initialize framework (optional, for new projects)
437
+ - 📝 Generate final docs (platform-guides, navigation-guide, contributing)
438
+ - 📖 Generate AGENT.md (master documentation index)
439
+ - 📄 Generate README.md (with intelligent merge if needed)
440
+ - 🤖 Create tool-specific configs (based on AI selection)
395
441
 
396
- **Specifications:**
397
- - `specs/build-configuration.md` - Build configuration
398
- - `specs/deployment.md` - Deployment procedures
399
- - `specs/configuration.md` - Environment configuration
442
+ Continue to Phase 8? (yes/no)
443
+ ```
400
444
 
401
445
  ---
402
446
 
403
- **Last Updated:** 2025-01-XX
404
-
405
- **Version:** 1.4.0
406
-
447
+ **Last Updated:** 2025-12-09
407
448
 
449
+ **Version:** 2.0.0 (Unified workflow with Phase 8)