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.
- package/README.md +97 -30
- package/dist/cli.js +94 -110
- package/dist/cli.js.map +1 -1
- package/package.json +6 -2
- package/prompts/backend/{flow-bootstrap-phase-0.md → flow-build-phase-0.md} +5 -3
- package/prompts/backend/{flow-bootstrap-phase-1.md → flow-build-phase-1.md} +36 -41
- package/prompts/backend/{flow-bootstrap-phase-2.md → flow-build-phase-2.md} +80 -68
- package/prompts/backend/{flow-bootstrap-phase-3.md → flow-build-phase-3.md} +82 -61
- package/prompts/backend/{flow-bootstrap-phase-5.md → flow-build-phase-5.md} +10 -9
- package/prompts/backend/{flow-bootstrap-phase-6.md → flow-build-phase-6.md} +8 -7
- package/prompts/backend/{flow-bootstrap-phase-7.md → flow-build-phase-7.md} +5 -3
- package/prompts/backend/{flow-bootstrap-phase-8.md → flow-build-phase-8.md} +410 -543
- package/prompts/backend/{flow-bootstrap-phase-9.md → flow-build-phase-9.md} +472 -91
- package/prompts/backend/{flow-bootstrap.md → flow-build.md} +212 -140
- package/prompts/backend/flow-dev-feature.md +447 -68
- package/prompts/backend/flow-dev-fix.md +81 -8
- package/prompts/backend/flow-docs-sync.md +2 -1
- package/prompts/frontend/{flow-bootstrap-phase-0.md → flow-build-phase-0.md} +3 -2
- package/prompts/frontend/{flow-bootstrap-phase-1.md → flow-build-phase-1.md} +2 -1
- package/prompts/frontend/{flow-bootstrap-phase-2.md → flow-build-phase-2.md} +2 -1
- package/prompts/frontend/{flow-bootstrap-phase-3.md → flow-build-phase-3.md} +2 -1
- package/prompts/frontend/{flow-bootstrap-phase-4.md → flow-build-phase-4.md} +4 -2
- package/prompts/frontend/{flow-bootstrap-phase-5.md → flow-build-phase-5.md} +2 -1
- package/prompts/frontend/{flow-bootstrap-phase-6.md → flow-build-phase-6.md} +2 -1
- package/prompts/frontend/{flow-bootstrap-phase-8.md → flow-build-phase-8.md} +238 -22
- package/prompts/frontend/{flow-bootstrap.md → flow-build.md} +108 -25
- package/prompts/frontend/flow-docs-sync.md +3 -2
- package/prompts/mobile/{flow-bootstrap-phase-0.md → flow-build-phase-0.md} +3 -2
- package/prompts/mobile/{flow-bootstrap-phase-1.md → flow-build-phase-1.md} +2 -1
- package/prompts/mobile/{flow-bootstrap-phase-2.md → flow-build-phase-2.md} +2 -1
- package/prompts/mobile/{flow-bootstrap-phase-3.md → flow-build-phase-3.md} +2 -1
- package/prompts/mobile/{flow-bootstrap-phase-4.md → flow-build-phase-4.md} +2 -1
- package/prompts/mobile/{flow-bootstrap-phase-5.md → flow-build-phase-5.md} +2 -1
- package/prompts/mobile/{flow-bootstrap-phase-6.md → flow-build-phase-6.md} +2 -1
- package/prompts/mobile/{flow-bootstrap-phase-8.md → flow-build-phase-8.md} +249 -23
- package/prompts/mobile/{flow-bootstrap.md → flow-build.md} +107 -26
- package/prompts/mobile/flow-docs-sync.md +3 -2
- package/templates/{mobile/AGENT.template.md → AGENT.template.md} +2 -17
- package/templates/backend/.clauderules.template +1 -1
- package/templates/backend/.cursorrules.template +1 -1
- package/templates/shared/AGENT.template.md +0 -252
- /package/prompts/backend/{flow-bootstrap-phase-4.md → flow-build-phase-4.md} +0 -0
- /package/prompts/frontend/{flow-bootstrap-phase-7.md → flow-build-phase-7.md} +0 -0
- /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
|
|
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 `/
|
|
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 `/
|
|
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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|