ai-flow-dev 1.3.0 → 2.0.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 (44) hide show
  1. package/README.md +97 -30
  2. package/dist/cli.js +94 -110
  3. package/dist/cli.js.map +1 -1
  4. package/package.json +6 -2
  5. package/prompts/backend/{flow-bootstrap-phase-0.md → flow-build-phase-0.md} +5 -3
  6. package/prompts/backend/{flow-bootstrap-phase-1.md → flow-build-phase-1.md} +36 -41
  7. package/prompts/backend/{flow-bootstrap-phase-2.md → flow-build-phase-2.md} +80 -68
  8. package/prompts/backend/{flow-bootstrap-phase-3.md → flow-build-phase-3.md} +82 -61
  9. package/prompts/backend/{flow-bootstrap-phase-5.md → flow-build-phase-5.md} +10 -9
  10. package/prompts/backend/{flow-bootstrap-phase-6.md → flow-build-phase-6.md} +8 -7
  11. package/prompts/backend/{flow-bootstrap-phase-7.md → flow-build-phase-7.md} +5 -3
  12. package/prompts/backend/{flow-bootstrap-phase-8.md → flow-build-phase-8.md} +410 -543
  13. package/prompts/backend/{flow-bootstrap-phase-9.md → flow-build-phase-9.md} +472 -91
  14. package/prompts/backend/{flow-bootstrap.md → flow-build.md} +212 -140
  15. package/prompts/backend/flow-dev-feature.md +447 -68
  16. package/prompts/backend/flow-dev-fix.md +81 -8
  17. package/prompts/backend/flow-docs-sync.md +2 -1
  18. package/prompts/frontend/{flow-bootstrap-phase-0.md → flow-build-phase-0.md} +3 -2
  19. package/prompts/frontend/{flow-bootstrap-phase-1.md → flow-build-phase-1.md} +2 -1
  20. package/prompts/frontend/{flow-bootstrap-phase-2.md → flow-build-phase-2.md} +2 -1
  21. package/prompts/frontend/{flow-bootstrap-phase-3.md → flow-build-phase-3.md} +2 -1
  22. package/prompts/frontend/{flow-bootstrap-phase-4.md → flow-build-phase-4.md} +4 -2
  23. package/prompts/frontend/{flow-bootstrap-phase-5.md → flow-build-phase-5.md} +2 -1
  24. package/prompts/frontend/{flow-bootstrap-phase-6.md → flow-build-phase-6.md} +2 -1
  25. package/prompts/frontend/{flow-bootstrap-phase-8.md → flow-build-phase-8.md} +238 -22
  26. package/prompts/frontend/{flow-bootstrap.md → flow-build.md} +108 -25
  27. package/prompts/frontend/flow-docs-sync.md +3 -2
  28. package/prompts/mobile/{flow-bootstrap-phase-0.md → flow-build-phase-0.md} +3 -2
  29. package/prompts/mobile/{flow-bootstrap-phase-1.md → flow-build-phase-1.md} +2 -1
  30. package/prompts/mobile/{flow-bootstrap-phase-2.md → flow-build-phase-2.md} +2 -1
  31. package/prompts/mobile/{flow-bootstrap-phase-3.md → flow-build-phase-3.md} +2 -1
  32. package/prompts/mobile/{flow-bootstrap-phase-4.md → flow-build-phase-4.md} +2 -1
  33. package/prompts/mobile/{flow-bootstrap-phase-5.md → flow-build-phase-5.md} +2 -1
  34. package/prompts/mobile/{flow-bootstrap-phase-6.md → flow-build-phase-6.md} +2 -1
  35. package/prompts/mobile/{flow-bootstrap-phase-8.md → flow-build-phase-8.md} +249 -23
  36. package/prompts/mobile/{flow-bootstrap.md → flow-build.md} +107 -26
  37. package/prompts/mobile/flow-docs-sync.md +3 -2
  38. package/templates/{mobile/AGENT.template.md → AGENT.template.md} +2 -17
  39. package/templates/backend/.clauderules.template +1 -1
  40. package/templates/backend/.cursorrules.template +1 -1
  41. package/templates/shared/AGENT.template.md +0 -252
  42. /package/prompts/backend/{flow-bootstrap-phase-4.md → flow-build-phase-4.md} +0 -0
  43. /package/prompts/frontend/{flow-bootstrap-phase-7.md → flow-build-phase-7.md} +0 -0
  44. /package/prompts/mobile/{flow-bootstrap-phase-7.md → flow-build-phase-7.md} +0 -0
@@ -25,6 +25,7 @@
25
25
  **Database:** {{DATABASE}} with {{ORM}}
26
26
 
27
27
  **Key Characteristics:**
28
+
28
29
  - Authentication: {{AUTH_METHOD}}
29
30
  - API Style: {{API_STYLE}}
30
31
  - Deployment: {{DEPLOYMENT_PLATFORM}}
@@ -43,80 +44,67 @@ All documentation is structured to guide AI assistants in understanding the proj
43
44
  ### 📚 Core Documentation (Read in Order)
44
45
 
45
46
  1. **`ai-instructions.md`** ⭐ **START HERE**
46
-
47
47
  - Tech stack and versions
48
48
  - NEVER/ALWAYS rules
49
49
  - Development workflow
50
50
  - Priorities
51
51
 
52
52
  2. **`project-brief.md`**
53
-
54
53
  - Business context
55
54
  - Objectives and scope
56
55
  - Constraints and success metrics
57
56
 
58
57
  3. **`README.md`**
59
-
60
58
  - Quick start
61
59
  - Installation and commands
62
60
  - Project directory tour
63
61
 
64
62
  4. **`docs/architecture.md`**
65
-
66
63
  - System architecture pattern
67
64
  - Component structure
68
65
  - Request/response flow
69
66
 
70
67
  5. **`docs/data-model.md`**
71
-
72
68
  - Database schema
73
69
  - Entity relationships
74
70
  - Data patterns
75
71
 
76
72
  6. **`docs/code-standards.md`**
77
-
78
73
  - Naming conventions
79
74
  - Code quality rules
80
75
  - Error handling patterns
81
76
 
82
77
  7. **`docs/testing.md`**
83
-
84
78
  - Testing strategy
85
79
  - Coverage requirements
86
80
  - Test patterns
87
81
 
88
82
  8. **`docs/operations.md`**
89
-
90
83
  - Deployment procedures
91
84
  - Monitoring and alerts
92
85
  - Scaling strategy
93
86
 
94
87
  9. **`docs/business-flows.md`**
95
-
96
88
  - End-to-end business processes
97
89
  - Key actors and systems
98
90
  - Flow diagrams
99
91
 
100
92
  10. **`docs/api.md`**
101
-
102
93
  - Endpoint conventions
103
94
  - Authentication and pagination rules
104
95
  - Request/response examples
105
96
 
106
97
  11. **`docs/contributing.md`**
107
-
108
98
  - Development setup
109
99
  - Contribution guidelines
110
100
  - Code review process
111
101
 
112
102
  12. **`specs/security.md`**
113
-
114
103
  - Authentication/Authorization
115
104
  - Security policies
116
105
  - Compliance requirements
117
106
 
118
107
  13. **`specs/configuration.md`**
119
-
120
108
  - Environment variables
121
109
  - External services
122
110
  - Configuration by environment
@@ -162,20 +150,17 @@ All documentation is structured to guide AI assistants in understanding the proj
162
150
  When working on this project:
163
151
 
164
152
  1. **Before starting ANY task:**
165
-
166
153
  - Read `ai-instructions.md` for project-wide rules
167
154
  - Check relevant documentation for the area you're working on
168
155
  - Understand the business context from `project-brief.md`
169
156
 
170
157
  2. **When implementing features:**
171
-
172
158
  - Follow architecture patterns from `docs/architecture.md`
173
159
  - Respect data models from `docs/data-model.md`
174
160
  - Apply code standards from `docs/code-standards.md`
175
161
  - Add tests according to `docs/testing.md`
176
162
 
177
163
  3. **When handling security:**
178
-
179
164
  - Consult `specs/security.md` for auth/authz
180
165
  - Never hardcode secrets (use `specs/configuration.md`)
181
166
  - Follow security headers and encryption requirements
@@ -248,4 +233,4 @@ See `README.md` for installation and setup instructions.
248
233
 
249
234
  **Last Updated:** {{GENERATION_DATE}}
250
235
 
251
- **Generated by:** AI Flow v1.0.8
236
+ **Generated by:** AI Flow v2.0.1
@@ -99,7 +99,7 @@ This file contains Claude Code-specific preferences and workflows.
99
99
 
100
100
  ## 💡 Claude-Specific Tips
101
101
 
102
- - Use `/bootstrap` command for starting documentation generation
102
+ - Use `/flow-build` command for starting documentation generation
103
103
  - Use plan mode for architectural decisions
104
104
  - Reference `AGENT.md` for any clarifications
105
105
  - Ask user before making breaking changes
@@ -92,7 +92,7 @@ Read these files in order:
92
92
 
93
93
  - Use `@AGENT.md` to reference project context
94
94
  - Use `@ai-instructions.md` for coding rules
95
- - Run `/bootstrap` to start documentation generation
95
+ - Run `/flow-build` to start documentation generation
96
96
  - Check `docs/` folder for detailed specifications
97
97
 
98
98
  ---
@@ -1,252 +0,0 @@
1
- # AGENT.md
2
-
3
- > Universal AI Assistant Configuration
4
- >
5
- > This file provides context for ALL AI development tools (Claude, Copilot, Cursor, Gemini, etc.)
6
-
7
- ---
8
-
9
- ## 📋 About This Project
10
-
11
- **Project Name:** {{PROJECT_NAME}}
12
-
13
- **Description:** {{PROJECT_DESCRIPTION}}
14
-
15
- **Problem We're Solving:** {{PROBLEM_STATEMENT}}
16
-
17
- **Target Users:** {{TARGET_USERS}}
18
-
19
- ### Technical Context
20
-
21
- **Project Type:** Backend API/Service
22
- **Architecture:** {{ARCHITECTURE_PATTERN}}
23
- **Primary Language:** {{LANGUAGE}} {{LANGUAGE_VERSION}}
24
- **Framework:** {{FRAMEWORK}}
25
- **Database:** {{DATABASE}} with {{ORM}}
26
-
27
- **Key Characteristics:**
28
-
29
- - Authentication: {{AUTH_METHOD}}
30
- - API Style: {{API_STYLE}}
31
- - Deployment: {{DEPLOYMENT_PLATFORM}}
32
- - Current Phase: {{PROJECT_PHASE}}
33
-
34
- > This project uses AI-assisted development with comprehensive documentation.
35
- > All files below provide context to AI assistants for consistent, high-quality code generation.
36
-
37
- ---
38
-
39
- ## 🏗️ Documentation Architecture
40
-
41
- This project follows **AI-assisted development** with comprehensive documentation.
42
- All documentation is structured to guide AI assistants in understanding the project deeply.
43
-
44
- ### 📚 Core Documentation (Read in Order)
45
-
46
- 1. **`ai-instructions.md`** ⭐ **START HERE**
47
-
48
- - Tech stack and versions
49
- - NEVER/ALWAYS rules
50
- - Development workflow
51
- - Priorities
52
-
53
- 2. **`project-brief.md`**
54
-
55
- - Business context
56
- - Objectives and scope
57
- - Constraints and success metrics
58
-
59
- 3. **`README.md`**
60
-
61
- - Quick start
62
- - Installation and commands
63
- - Project directory tour
64
-
65
- 4. **`docs/architecture.md`**
66
-
67
- - System architecture pattern
68
- - Component structure
69
- - Request/response flow
70
-
71
- 5. **`docs/data-model.md`**
72
-
73
- - Database schema
74
- - Entity relationships
75
- - Data patterns
76
-
77
- 6. **`docs/code-standards.md`**
78
-
79
- - Naming conventions
80
- - Code quality rules
81
- - Error handling patterns
82
-
83
- 7. **`docs/testing.md`**
84
-
85
- - Testing strategy
86
- - Coverage requirements
87
- - Test patterns
88
-
89
- 8. **`docs/operations.md`**
90
-
91
- - Deployment procedures
92
- - Monitoring and alerts
93
- - Scaling strategy
94
-
95
- 9. **`docs/business-flows.md`**
96
-
97
- - End-to-end business processes
98
- - Key actors and systems
99
- - Flow diagrams
100
-
101
- 10. **`docs/api.md`**
102
-
103
- - Endpoint conventions
104
- - Authentication and pagination rules
105
- - Request/response examples
106
-
107
- 11. **`docs/contributing.md`**
108
-
109
- - Development setup
110
- - Contribution guidelines
111
- - Code review process
112
-
113
- 12. **`specs/security.md`**
114
-
115
- - Authentication/Authorization
116
- - Security policies
117
- - Compliance requirements
118
-
119
- 13. **`specs/configuration.md`**
120
-
121
- - Environment variables
122
- - External services
123
- - Configuration by environment
124
-
125
- 14. **`.env.example`**
126
- - Required environment variables
127
- - Default/local values
128
- - Secrets handling guidance
129
-
130
- ---
131
-
132
- ## ⚡ Quick Reference
133
-
134
- ### Tech Stack
135
-
136
- **Backend:**
137
-
138
- - Framework: {{FRAMEWORK}}
139
- - Language: {{LANGUAGE}} {{LANGUAGE_VERSION}}
140
- - Database: {{DATABASE}}
141
- - ORM: {{ORM}}
142
- - Authentication: {{AUTH_METHOD}}
143
- - Caching: {{CACHE_STRATEGY}}
144
-
145
- **Infrastructure:**
146
-
147
- - Deployment: {{DEPLOYMENT_PLATFORM}}
148
- - CI/CD: {{CICD_PLATFORM}}
149
- - Monitoring: {{MONITORING_TOOLS}}
150
-
151
- ### Critical Rules
152
-
153
- **❌ NEVER:**
154
- {{NEVER_RULES}}
155
-
156
- **✅ ALWAYS:**
157
- {{ALWAYS_RULES}}
158
-
159
- ---
160
-
161
- ## 🤖 AI Assistant Workflow
162
-
163
- When working on this project:
164
-
165
- 1. **Before starting ANY task:**
166
-
167
- - Read `ai-instructions.md` for project-wide rules
168
- - Check relevant documentation for the area you're working on
169
- - Understand the business context from `project-brief.md`
170
-
171
- 2. **When implementing features:**
172
-
173
- - Follow architecture patterns from `docs/architecture.md`
174
- - Respect data models from `docs/data-model.md`
175
- - Apply code standards from `docs/code-standards.md`
176
- - Add tests according to `docs/testing.md`
177
-
178
- 3. **When handling security:**
179
-
180
- - Consult `specs/security.md` for auth/authz
181
- - Never hardcode secrets (use `specs/configuration.md`)
182
- - Follow security headers and encryption requirements
183
-
184
- 4. **When deploying:**
185
- - Follow procedures in `docs/operations.md`
186
- - Update configuration per environment
187
- - Check health endpoints
188
-
189
- ---
190
-
191
- ## 🛠️ Tool-Specific Configurations
192
-
193
- Different AI tools have specific configuration files that extend this AGENT.md:
194
-
195
- ### Claude Code
196
-
197
- - **File:** `.clauderules`
198
- - **Purpose:** Claude-specific instructions and preferences
199
- - **References:** This AGENT.md + project docs
200
-
201
- ### Cursor
202
-
203
- - **File:** `.cursorrules`
204
- - **Purpose:** Cursor-specific context and rules
205
- - **References:** This AGENT.md + project docs
206
-
207
- ### GitHub Copilot
208
-
209
- - **File:** `.github/copilot-instructions.md`
210
- - **Purpose:** Copilot workspace instructions
211
- - **References:** This AGENT.md + project docs
212
-
213
- **All tool-specific configs reference this AGENT.md as the source of truth.**
214
-
215
- ---
216
-
217
- ## 📊 Project Status
218
-
219
- **Current Phase:** {{PROJECT_PHASE}}
220
-
221
- **Architecture:** {{ARCHITECTURE_PATTERN}}
222
-
223
- **Compliance:** {{COMPLIANCE_REQUIREMENTS}}
224
-
225
- ---
226
-
227
- ## 🚀 Getting Started
228
-
229
- ### For AI Assistants
230
-
231
- 1. Read this AGENT.md completely
232
- 2. Read `ai-instructions.md` for critical rules
233
- 3. Familiarize with `docs/architecture.md`
234
- 4. Review `docs/code-standards.md` for coding patterns
235
- 5. Check `specs/security.md` before handling auth/sensitive data
236
-
237
- ### For Developers
238
-
239
- See `README.md` for installation and setup instructions.
240
-
241
- ---
242
-
243
- ## 📝 Document Update Policy
244
-
245
- - Documents are **living artifacts** - update as project evolves
246
- - Breaking changes to architecture → Update `docs/architecture.md`
247
- - New security requirements → Update `specs/security.md`
248
- - Stack changes → Update `ai-instructions.md` AND this AGENT.md
249
-
250
- **Last Updated:** {{GENERATION_DATE}}
251
-
252
- **Generated by:** AI Flow v1.3.0