ai-flow-dev 1.0.2 → 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 -248
  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
@@ -41,21 +41,22 @@ This documentation is **modularized** for better maintainability and performance
41
41
 
42
42
  Execute phases sequentially by reading each file in order:
43
43
 
44
- 1. **Phase 0 (Optional - Existing Projects Only):** Read `.ai-flow/prompts/mobile/flow-docs-gen-phase-0-context.md`
45
- 2. **Phase 1 (Platform & Framework Selection):** Read `.ai-flow/prompts/mobile/flow-docs-gen-phase-1-platform.md`
46
- 3. **Phase 2 (Navigation & Architecture):** Read `.ai-flow/prompts/mobile/flow-docs-gen-phase-2-navigation.md`
47
- 4. **Phase 3 (State & Data Management):** Read `.ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md`
48
- 5. **Phase 4 (Permissions & Native Features):** Read `.ai-flow/prompts/mobile/flow-docs-gen-phase-4-permissions.md`
49
- 6. **Phase 5 (Code Standards):** Read `.ai-flow/prompts/mobile/flow-docs-gen-phase-5-standards.md`
50
- 7. **Phase 6 (Testing Strategy):** Read `.ai-flow/prompts/mobile/flow-docs-gen-phase-6-testing.md`
51
- 8. **Phase 7 (Store Deployment):** Read `.ai-flow/prompts/mobile/flow-docs-gen-phase-7-deployment.md`
44
+ 1. **Phase 0 (Optional - Existing Projects Only):** Read `.ai-flow/prompts/mobile/flow-bootstrap-phase-0-context.md`
45
+ 2. **Phase 1 (Platform & Framework Selection):** Read `.ai-flow/prompts/mobile/flow-bootstrap-phase-1-platform.md`
46
+ 3. **Phase 2 (Navigation & Architecture):** Read `.ai-flow/prompts/mobile/flow-bootstrap-phase-2-navigation.md`
47
+ 4. **Phase 3 (State & Data Management):** Read `.ai-flow/prompts/mobile/flow-bootstrap-phase-3-state.md`
48
+ 5. **Phase 4 (Permissions & Native Features):** Read `.ai-flow/prompts/mobile/flow-bootstrap-phase-4-permissions.md`
49
+ 6. **Phase 5 (Code Standards):** Read `.ai-flow/prompts/mobile/flow-bootstrap-phase-5-standards.md`
50
+ 7. **Phase 6 (Testing Strategy):** Read `.ai-flow/prompts/mobile/flow-bootstrap-phase-6-testing.md`
51
+ 8. **Phase 7 (Store Deployment):** Read `.ai-flow/prompts/mobile/flow-bootstrap-phase-7-deployment.md`
52
+ 9. **Phase 8 (Project Setup & Final Documentation):** Read `.ai-flow/prompts/mobile/flow-bootstrap-phase-8.md`
52
53
 
53
54
  ### For Individual Phases
54
55
 
55
56
  You can execute any phase independently by reading its file. For example:
56
57
 
57
58
  ```
58
- Read .ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md and execute only Phase 3
59
+ Read .ai-flow/prompts/mobile/flow-bootstrap-phase-3-state.md and execute only Phase 3
59
60
  ```
60
61
 
61
62
  ---
@@ -64,7 +65,7 @@ Read .ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md and execute only Pha
64
65
 
65
66
  ### Phase 0: Context Discovery (Optional)
66
67
 
67
- **File:** `mobile/flow-docs-gen-phase-0-context.md`
68
+ **File:** `mobile/flow-bootstrap-phase-0-context.md`
68
69
  **For:** Existing projects with code/documentation
69
70
  **Duration:** 1-5 minutes (automated analysis)
70
71
  **Output:** Pre-populated answers, project analysis
@@ -84,7 +85,7 @@ Read .ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md and execute only Pha
84
85
 
85
86
  ### Phase 1: Platform & Framework Selection
86
87
 
87
- **File:** `mobile/flow-docs-gen-phase-1-platform.md`
88
+ **File:** `mobile/flow-bootstrap-phase-1-platform.md`
88
89
  **Duration:** 20-25 minutes
89
90
  **Key Questions:**
90
91
 
@@ -107,7 +108,7 @@ Read .ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md and execute only Pha
107
108
 
108
109
  ### Phase 2: Navigation & Architecture
109
110
 
110
- **File:** `mobile/flow-docs-gen-phase-2-navigation.md`
111
+ **File:** `mobile/flow-bootstrap-phase-2-navigation.md`
111
112
  **Duration:** 15-20 minutes
112
113
  **Key Questions:**
113
114
 
@@ -126,7 +127,7 @@ Read .ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md and execute only Pha
126
127
 
127
128
  ### Phase 3: State & Data Management
128
129
 
129
- **File:** `mobile/flow-docs-gen-phase-3-state.md`
130
+ **File:** `mobile/flow-bootstrap-phase-3-state.md`
130
131
  **Duration:** 15-20 minutes
131
132
  **Key Questions:**
132
133
 
@@ -145,7 +146,7 @@ Read .ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md and execute only Pha
145
146
 
146
147
  ### Phase 4: Permissions & Native Features
147
148
 
148
- **File:** `mobile/flow-docs-gen-phase-4-permissions.md`
149
+ **File:** `mobile/flow-bootstrap-phase-4-permissions.md`
149
150
  **Duration:** 15-20 minutes
150
151
  **Key Questions:**
151
152
 
@@ -164,7 +165,7 @@ Read .ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md and execute only Pha
164
165
 
165
166
  ### Phase 5: Code Standards & Best Practices
166
167
 
167
- **File:** `mobile/flow-docs-gen-phase-5-standards.md`
168
+ **File:** `mobile/flow-bootstrap-phase-5-standards.md`
168
169
  **Duration:** 15-20 minutes
169
170
  **Key Questions:**
170
171
 
@@ -182,7 +183,7 @@ Read .ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md and execute only Pha
182
183
 
183
184
  ### Phase 6: Testing Strategy
184
185
 
185
- **File:** `mobile/flow-docs-gen-phase-6-testing.md`
186
+ **File:** `mobile/flow-bootstrap-phase-6-testing.md`
186
187
  **Duration:** 15-25 minutes
187
188
  **Key Questions:**
188
189
 
@@ -201,7 +202,7 @@ Read .ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md and execute only Pha
201
202
 
202
203
  ### Phase 7: Store Deployment
203
204
 
204
- **File:** `mobile/flow-docs-gen-phase-7-deployment.md`
205
+ **File:** `mobile/flow-bootstrap-phase-7-deployment.md`
205
206
  **Duration:** 15-20 minutes
206
207
  **Key Questions:**
207
208
 
@@ -216,7 +217,32 @@ Read .ai-flow/prompts/mobile/flow-docs-gen-phase-3-state.md and execute only Pha
216
217
  - `docs/app-store.md`
217
218
  - `specs/build-configuration.md`
218
219
  - `specs/deployment.md`
219
- - Parts of `ai-instructions.md`
220
+ - `.env.example`
221
+
222
+ **Next:** Transitions to Phase 8 for project setup and final documentation
223
+
224
+ ---
225
+
226
+ ### Phase 8: Project Setup & Final Documentation
227
+
228
+ **File:** `mobile/flow-bootstrap-phase-8.md`
229
+ **Duration:** 10-15 minutes
230
+ **Key Steps:**
231
+
232
+ - Detect project state (new vs existing)
233
+ - Initialize framework (optional, for new projects)
234
+ - Generate final documentation
235
+ - Create master index (AGENT.md)
236
+ - Generate README.md with intelligent merge
237
+
238
+ **Generates:**
239
+
240
+ - `docs/platform-guides.md`
241
+ - `docs/navigation-guide.md`
242
+ - `docs/contributing.md`
243
+ - `AGENT.md` (master index)
244
+ - `README.md`
245
+ - Tool-specific configs (`.clauderules`, `.cursorrules`, `.github/copilot-instructions.md`)
220
246
 
221
247
  ---
222
248
 
@@ -412,13 +438,13 @@ To begin the complete mobile bootstrap process:
412
438
  **Ready to start?** Proceed to Phase 1 by reading:
413
439
 
414
440
  ```
415
- .ai-flow/prompts/mobile/flow-docs-gen-phase-1-platform.md
441
+ .ai-flow/prompts/mobile/flow-bootstrap-phase-1-platform.md
416
442
  ```
417
443
 
418
444
  Or if you have existing code, start with Phase 0 for automatic detection:
419
445
 
420
446
  ```
421
- .ai-flow/prompts/mobile/flow-docs-gen-phase-0-context.md
447
+ .ai-flow/prompts/mobile/flow-bootstrap-phase-0-context.md
422
448
  ```
423
449
 
424
450
  ---
@@ -428,3 +454,4 @@ Or if you have existing code, start with Phase 0 for automatic detection:
428
454
  **Version:** 1.4.0 (Mobile MVP)
429
455
 
430
456
 
457
+
@@ -34,7 +34,7 @@ First, check if `.ai-flow/analysis.json` exists:
34
34
 
35
35
  1. **Perform Current Code Analysis:**
36
36
 
37
- - Execute the same analysis as Phase 0 (mobile/flow-docs-gen-phase-0-context.md):
37
+ - Execute the same analysis as Phase 0 (mobile/flow-bootstrap-phase-0-context.md):
38
38
  - File structure analysis
39
39
  - Screen and component detection
40
40
  - Navigation pattern detection
@@ -632,3 +632,4 @@ Documentation synchronized successfully.
632
632
  **BEGIN EXECUTION when user runs `/flow-docs-sync`**
633
633
 
634
634
 
635
+
@@ -1,248 +0,0 @@
1
- # AI Flow - Project Initialization
2
-
3
- **YOU ARE AN EXPERT DEVOPS ENGINEER AND PROJECT SETUP SPECIALIST.**
4
-
5
- Your mission is to initialize the project with the appropriate framework/language tooling when the user executes `/flow-project-init`.
6
-
7
- ---
8
-
9
- ## Command: `/flow-project-init`
10
-
11
- ### Objective
12
-
13
- Initialize a clean project in the **current directory** using the framework's official CLI tool based on the tech stack defined in the documentation. Do NOT create subdirectories or manual folder structures.
14
-
15
- ### Prerequisites
16
-
17
- Before executing this command, ensure:
18
-
19
- - ✅ `/flow-docs-gen` completed (documentation generated)
20
- - ✅ `ai-instructions.md` exists with tech stack defined
21
- - ✅ Current directory is empty or ready for initialization
22
-
23
- ### Duration
24
-
25
- ⏱️ **Estimated Time:** 5-10 minutes
26
-
27
- ---
28
-
29
- ## Workflow: 2 Steps
30
-
31
- ### Step 1: Read Documentation (1 minute - automatic)
32
-
33
- **Read `ai-instructions.md` to identify:**
34
-
35
- - Programming language and version
36
- - Framework and version (if any)
37
- - Package manager preference
38
-
39
- **Display summary:**
40
-
41
- ```
42
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
43
- 📊 Project Configuration
44
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
45
-
46
- 📦 Language: {{LANGUAGE}} {{VERSION}}
47
- 🚀 Framework: {{FRAMEWORK}} {{VERSION}}
48
- 📦 Package Manager: {{PACKAGE_MANAGER}}
49
-
50
- Target Directory: {{PWD}}
51
-
52
- ⚠️ IMPORTANT: This will initialize the project in the CURRENT directory.
53
- No subdirectories will be created.
54
-
55
- Continue? (Y/n)
56
- ```
57
-
58
- **If framework not detected:**
59
-
60
- Ask user to specify the framework:
61
-
62
- ```
63
- ⚠️ Framework not specified in ai-instructions.md
64
-
65
- Please specify the framework to use:
66
- >
67
- ```
68
-
69
- ---
70
-
71
- ### Step 2: Execute Initialization Command (5-10 minutes)
72
-
73
- **Run the framework's official initialization command in the CURRENT directory:**
74
-
75
- ```
76
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
77
- 🏗️ Step 2/2: Initialize Project
78
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
79
- ```
80
-
81
- **CRITICAL RULES:**
82
-
83
- 1. ✅ **Initialize in current directory** (use `.` when the CLI supports it)
84
- 2. ✅ **Use official CLI tools** (don't create manual folder structures)
85
- 3. ❌ **DO NOT create subdirectories** (no `mkdir project-name`)
86
- 4. ❌ **DO NOT create manual file structures**
87
-
88
- ---
89
-
90
- **Framework-Specific Commands:**
91
-
92
- **Node.js / TypeScript:**
93
-
94
- ```bash
95
- # NestJS
96
- npx @nestjs/cli new . --package-manager npm --skip-git
97
-
98
- # Express + TypeScript
99
- npm init -y
100
- npm install express
101
- npm install -D typescript @types/express @types/node ts-node nodemon
102
- npx tsc --init
103
-
104
- # Fastify + TypeScript
105
- npm init -y
106
- npm install fastify
107
- npm install -D typescript @types/node tsx
108
-
109
- # Next.js (if applicable)
110
- npx create-next-app@latest . --typescript --tailwind --app --import-alias "@/*"
111
- ```
112
-
113
- **Python:**
114
-
115
- ```bash
116
- # Django
117
- python -m venv venv
118
- # Windows: venv\Scripts\activate | Unix: source venv/bin/activate
119
- pip install django djangorestframework
120
- django-admin startproject config .
121
-
122
- # FastAPI
123
- python -m venv venv
124
- # Windows: venv\Scripts\activate | Unix: source venv/bin/activate
125
- pip install "fastapi[standard]" uvicorn sqlalchemy
126
-
127
- # Flask
128
- python -m venv venv
129
- # Windows: venv\Scripts\activate | Unix: source venv/bin/activate
130
- pip install flask flask-restful flask-sqlalchemy
131
- ```
132
-
133
- **Go:**
134
-
135
- ```bash
136
- # Go (any framework)
137
- go mod init {{PROJECT_NAME}}
138
-
139
- # Then install dependencies (examples):
140
- # Gin: go get -u github.com/gin-gonic/gin
141
- # Echo: go get github.com/labstack/echo/v4
142
- # Fiber: go get github.com/gofiber/fiber/v2
143
- ```
144
-
145
- **C# / .NET:**
146
-
147
- ```bash
148
- # ASP.NET Core Web API
149
- dotnet new webapi -n {{PROJECT_NAME}} -o .
150
- dotnet add package Microsoft.EntityFrameworkCore.Design
151
- dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL
152
- ```
153
-
154
- **Ruby:**
155
-
156
- ```bash
157
- # Rails API
158
- rails new . --api --database=postgresql --skip-git
159
- ```
160
-
161
- **PHP:**
162
-
163
- ```bash
164
- # Laravel
165
- composer create-project laravel/laravel tmp-laravel
166
- mv tmp-laravel/* . && mv tmp-laravel/.* . 2>/dev/null || true
167
- rm -rf tmp-laravel
168
-
169
- # Symfony
170
- composer create-project symfony/skeleton tmp-symfony
171
- mv tmp-symfony/* . && mv tmp-symfony/.* . 2>/dev/null || true
172
- rm -rf tmp-symfony
173
- ```
174
-
175
- **Java / Kotlin:**
176
-
177
- ```bash
178
- # Spring Boot (Maven)
179
- curl https://start.spring.io/starter.zip \
180
- -d type=maven-project \
181
- -d language=java \
182
- -d bootVersion=3.2.0 \
183
- -d dependencies=web,data-jpa \
184
- -o project.zip
185
- unzip -o project.zip && rm project.zip
186
-
187
- # Spring Boot (Gradle + Kotlin)
188
- curl https://start.spring.io/starter.zip \
189
- -d type=gradle-project-kotlin \
190
- -d language=kotlin \
191
- -d bootVersion=3.2.0 \
192
- -d dependencies=web,data-jpa \
193
- -o project.zip
194
- unzip -o project.zip && rm project.zip
195
- ```
196
-
197
- ---
198
-
199
- **Success Output:**
200
-
201
- ```
202
- ✅ Project initialized successfully!
203
-
204
- 📦 Framework: {{FRAMEWORK}} {{VERSION}}
205
- 📂 Files created: {{FILE_COUNT}} files
206
- ⏱️ Time: {{DURATION}}
207
-
208
- Generated structure:
209
- {{LIST_KEY_FILES}}
210
-
211
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
212
-
213
- Next steps:
214
- 1. Review generated files
215
- 2. Run /flow-project-roadmap to plan implementation
216
- 3. Start development with /feature commands
217
- ```
218
-
219
- ---
220
-
221
- ## Important Notes
222
-
223
- **What this command DOES:**
224
-
225
- - ✅ Runs the official framework CLI (npx, django-admin, dotnet new, etc.)
226
- - ✅ Creates base project files in current directory
227
- - ✅ Installs initial dependencies
228
- - ✅ Sets up configuration files (tsconfig.json, package.json, etc.)
229
-
230
- **What this command DOES NOT do:**
231
-
232
- - ❌ Create custom folder structures (use /feature for that later)
233
- - ❌ Implement Clean Architecture layers manually
234
- - ❌ Create domain entities or use cases
235
- - ❌ Set up database schemas
236
- - ❌ Configure CI/CD pipelines
237
-
238
- **Philosophy:**
239
-
240
- This command provides a **clean slate** from the official tooling. The architecture, domain logic, and custom structure will be built incrementally using `/feature`, `/fix`, and `/work` commands following the patterns defined in your documentation.
241
-
242
- ---
243
-
244
- **End of /flow-project-init workflow**
245
-
246
- **Time:** 5-10 minutes total
247
- **Output:** Clean framework initialization in current directory
248
- **Next:** Run `/flow-project-roadmap` to generate implementation plan