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.
- package/README.md +25 -38
- package/dist/cli.js +68 -46
- package/dist/cli.js.map +1 -1
- package/package.json +5 -5
- package/prompts/backend/flow-build-phase-0.md +31 -63
- package/prompts/backend/flow-build-phase-1.md +9 -17
- package/prompts/backend/flow-build-phase-10.md +199 -585
- package/prompts/backend/flow-build-phase-2.md +152 -86
- package/prompts/backend/flow-build-phase-3.md +108 -68
- package/prompts/backend/flow-build-phase-4.md +5 -8
- package/prompts/backend/flow-build-phase-5.md +39 -12
- package/prompts/backend/flow-build-phase-6.md +29 -8
- package/prompts/backend/flow-build-phase-7.md +120 -40
- package/prompts/backend/flow-build-phase-8.md +28 -65
- package/prompts/backend/flow-build-phase-9.md +267 -1298
- package/prompts/backend/flow-build.md +881 -957
- package/prompts/backend/flow-dev-commit.md +27 -50
- package/prompts/backend/flow-dev-feature.md +1929 -2017
- package/prompts/backend/flow-dev-fix.md +936 -964
- package/prompts/backend/flow-dev-refactor.md +672 -701
- package/prompts/backend/flow-dev-review.md +356 -389
- package/prompts/backend/flow-dev-work.md +1066 -1118
- package/prompts/backend/flow-docs-sync.md +20 -196
- package/prompts/frontend/flow-build-phase-0.md +503 -484
- package/prompts/frontend/flow-build-phase-1.md +445 -433
- package/prompts/frontend/flow-build-phase-2.md +910 -957
- package/prompts/frontend/flow-build-phase-3.md +692 -664
- package/prompts/frontend/flow-build-phase-4.md +478 -463
- package/prompts/frontend/flow-build-phase-5.md +488 -467
- package/prompts/frontend/flow-build-phase-6.md +571 -550
- package/prompts/frontend/flow-build-phase-7.md +560 -592
- package/prompts/frontend/flow-build-phase-8.md +17 -42
- package/prompts/frontend/flow-build.md +457 -503
- package/prompts/frontend/flow-docs-sync.md +14 -35
- package/prompts/mobile/flow-build-phase-0.md +104 -97
- package/prompts/mobile/flow-build-phase-1.md +137 -122
- package/prompts/mobile/flow-build-phase-2.md +123 -130
- package/prompts/mobile/flow-build-phase-3.md +144 -149
- package/prompts/mobile/flow-build-phase-4.md +140 -132
- package/prompts/mobile/flow-build-phase-5.md +70 -70
- package/prompts/mobile/flow-build-phase-6.md +136 -134
- package/prompts/mobile/flow-build-phase-7.md +24 -58
- package/prompts/mobile/flow-build-phase-8.md +17 -42
- package/prompts/mobile/flow-build.md +47 -97
- package/prompts/mobile/flow-docs-sync.md +13 -32
- package/prompts/shared/mermaid-guidelines.md +106 -0
- package/prompts/shared/scope-levels.md +126 -0
- package/prompts/shared/story-points.md +65 -0
- package/prompts/shared/task-format.md +86 -0
- package/templates/AGENT.template.md +194 -15
- package/templates/backend/README.template.md +2 -32
- package/templates/backend/ai-instructions.template.md +2 -32
- package/templates/backend/copilot-instructions.template.md +2 -22
- package/templates/backend/docs/api.template.md +89 -20
- package/templates/backend/docs/architecture.template.md +165 -53
- package/templates/backend/docs/business-flows.template.md +7 -14
- package/templates/backend/docs/code-standards.template.md +2 -38
- package/templates/backend/docs/contributing.template.md +2 -16
- package/templates/backend/docs/data-model.template.md +125 -21
- package/templates/backend/docs/operations.template.md +179 -50
- package/templates/backend/docs/testing.template.md +2 -42
- package/templates/backend/project-brief.template.md +2 -28
- package/templates/backend/specs/configuration.template.md +2 -14
- package/templates/backend/specs/security.template.md +2 -32
- package/templates/frontend/README.template.md +2 -18
- package/templates/frontend/ai-instructions.template.md +2 -20
- package/templates/frontend/docs/api-integration.template.md +12 -30
- package/templates/frontend/docs/components.template.md +2 -28
- package/templates/frontend/docs/error-handling.template.md +11 -27
- package/templates/frontend/docs/operations.template.md +8 -18
- package/templates/frontend/docs/performance.template.md +8 -18
- package/templates/frontend/docs/pwa.template.md +8 -18
- package/templates/frontend/docs/state-management.template.md +2 -28
- package/templates/frontend/docs/styling.template.md +2 -26
- package/templates/frontend/docs/testing.template.md +2 -28
- package/templates/frontend/project-brief.template.md +2 -16
- package/templates/frontend/specs/accessibility.template.md +8 -18
- package/templates/frontend/specs/configuration.template.md +2 -24
- package/templates/frontend/specs/security.template.md +10 -24
- package/templates/fullstack/README.template.md +17 -47
- package/templates/fullstack/ai-instructions.template.md +17 -45
- package/templates/fullstack/project-brief.template.md +16 -42
- package/templates/fullstack/specs/configuration.template.md +16 -42
- package/templates/mobile/README.template.md +11 -29
- package/templates/mobile/ai-instructions.template.md +11 -27
- package/templates/mobile/docs/app-store.template.md +11 -29
- package/templates/mobile/docs/architecture.template.md +14 -38
- package/templates/mobile/docs/native-features.template.md +16 -44
- package/templates/mobile/docs/navigation.template.md +9 -23
- package/templates/mobile/docs/offline-strategy.template.md +10 -26
- package/templates/mobile/docs/permissions.template.md +9 -23
- package/templates/mobile/docs/state-management.template.md +12 -32
- package/templates/mobile/docs/testing.template.md +14 -38
- package/templates/mobile/project-brief.template.md +12 -30
- package/templates/mobile/specs/build-configuration.template.md +10 -26
- 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
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
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
|
+
|