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
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
# AI Instructions - Full Stack
|
|
2
2
|
|
|
3
3
|
> **CRITICAL:** Every AI assistant MUST read and follow this document before any work.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## ๐ฏ Project Overview
|
|
8
6
|
|
|
9
7
|
**Name:** {{PROJECT_NAME}}
|
|
@@ -13,9 +11,7 @@
|
|
|
13
11
|
**Purpose:** {{PROBLEM_STATEMENT}}
|
|
14
12
|
|
|
15
13
|
**Target Users:** {{TARGET_USERS}}
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
14
|
+
---
|
|
19
15
|
## ๐๏ธ Tech Stack
|
|
20
16
|
|
|
21
17
|
### Backend
|
|
@@ -90,9 +86,7 @@
|
|
|
90
86
|
### Key Libraries
|
|
91
87
|
|
|
92
88
|
{{KEY_LIBRARIES}}
|
|
93
|
-
|
|
94
|
-
---
|
|
95
|
-
|
|
89
|
+
---
|
|
96
90
|
## ๐๏ธ Architecture
|
|
97
91
|
|
|
98
92
|
**Backend Pattern:** {{ARCHITECTURE_PATTERN}}
|
|
@@ -109,9 +103,7 @@
|
|
|
109
103
|
```
|
|
110
104
|
{{FOLDER_STRUCTURE}}
|
|
111
105
|
```
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
106
|
+
---
|
|
115
107
|
## โ NEVER Rules
|
|
116
108
|
|
|
117
109
|
**YOU MUST NEVER:**
|
|
@@ -180,9 +172,7 @@
|
|
|
180
172
|
- โ Commit failing tests - All tests must pass before commit
|
|
181
173
|
|
|
182
174
|
{{CUSTOM_NEVER_RULES}}
|
|
183
|
-
|
|
184
|
-
---
|
|
185
|
-
|
|
175
|
+
---
|
|
186
176
|
## โ
ALWAYS Rules
|
|
187
177
|
|
|
188
178
|
**YOU MUST ALWAYS:**
|
|
@@ -270,9 +260,7 @@
|
|
|
270
260
|
- โ
Test accessibility (screen reader compatibility)
|
|
271
261
|
|
|
272
262
|
{{CUSTOM_ALWAYS_RULES}}
|
|
273
|
-
|
|
274
|
-
---
|
|
275
|
-
|
|
263
|
+
---
|
|
276
264
|
## ๐ Development Workflow
|
|
277
265
|
|
|
278
266
|
### 1. Before Starting a Task
|
|
@@ -318,9 +306,7 @@
|
|
|
318
306
|
- Test in staging before production
|
|
319
307
|
- Monitor logs after deployment
|
|
320
308
|
- Verify both backend and frontend deployments
|
|
321
|
-
|
|
322
|
-
---
|
|
323
|
-
|
|
309
|
+
---
|
|
324
310
|
## ๐ฏ Priorities
|
|
325
311
|
|
|
326
312
|
When there are trade-offs, prioritize in this order:
|
|
@@ -330,17 +316,13 @@ When there are trade-offs, prioritize in this order:
|
|
|
330
316
|
3. **{{PRIORITY_3}}** - {{PRIORITY_3_DESCRIPTION}}
|
|
331
317
|
4. **{{PRIORITY_4}}** - {{PRIORITY_4_DESCRIPTION}}
|
|
332
318
|
5. **{{PRIORITY_5}}** - {{PRIORITY_5_DESCRIPTION}}
|
|
333
|
-
|
|
334
|
-
---
|
|
335
|
-
|
|
319
|
+
---
|
|
336
320
|
## ๐ Project Structure
|
|
337
321
|
|
|
338
322
|
```
|
|
339
323
|
{{PROJECT_STRUCTURE}}
|
|
340
324
|
```
|
|
341
|
-
|
|
342
|
-
---
|
|
343
|
-
|
|
325
|
+
---
|
|
344
326
|
## ๐งช Testing Commands
|
|
345
327
|
|
|
346
328
|
**Backend:**
|
|
@@ -369,9 +351,7 @@ When there are trade-offs, prioritize in this order:
|
|
|
369
351
|
# Run E2E tests
|
|
370
352
|
{{PACKAGE_MANAGER}} run test:e2e
|
|
371
353
|
```
|
|
372
|
-
|
|
373
|
-
---
|
|
374
|
-
|
|
354
|
+
---
|
|
375
355
|
## ๐ Common Commands
|
|
376
356
|
|
|
377
357
|
**Backend:**
|
|
@@ -412,9 +392,7 @@ When there are trade-offs, prioritize in this order:
|
|
|
412
392
|
# Format code
|
|
413
393
|
{{PACKAGE_MANAGER}} run format
|
|
414
394
|
```
|
|
415
|
-
|
|
416
|
-
---
|
|
417
|
-
|
|
395
|
+
---
|
|
418
396
|
## ๐ Key Documentation Files
|
|
419
397
|
|
|
420
398
|
- `project-brief.md` - Business context and objectives
|
|
@@ -431,9 +409,7 @@ When there are trade-offs, prioritize in this order:
|
|
|
431
409
|
- `specs/security.md` - Security policies and compliance
|
|
432
410
|
- `specs/configuration.md` - Environment configuration
|
|
433
411
|
- `docs/contributing.md` - Development setup, workflow
|
|
434
|
-
|
|
435
|
-
---
|
|
436
|
-
|
|
412
|
+
---
|
|
437
413
|
## ๐ Environment Variables
|
|
438
414
|
|
|
439
415
|
See `.env.example` files in both `backend/` and `frontend/` directories for all required environment variables.
|
|
@@ -443,9 +419,7 @@ See `.env.example` files in both `backend/` and `frontend/` directories for all
|
|
|
443
419
|
|
|
444
420
|
**Frontend Critical Variables:**
|
|
445
421
|
{{FRONTEND_CRITICAL_VARS}}
|
|
446
|
-
|
|
447
|
-
---
|
|
448
|
-
|
|
422
|
+
---
|
|
449
423
|
## ๐ก๏ธ Security Checklist
|
|
450
424
|
|
|
451
425
|
Before every feature:
|
|
@@ -465,9 +439,7 @@ Before every feature:
|
|
|
465
439
|
- [ ] User input sanitized
|
|
466
440
|
- [ ] No API keys exposed
|
|
467
441
|
- [ ] Content Security Policy configured
|
|
468
|
-
|
|
469
|
-
---
|
|
470
|
-
|
|
442
|
+
---
|
|
471
443
|
## ๐ When in Doubt
|
|
472
444
|
|
|
473
445
|
1. Check this document first
|
|
@@ -476,12 +448,12 @@ Before every feature:
|
|
|
476
448
|
4. Ask for clarification before making architectural decisions
|
|
477
449
|
5. Prioritize security and maintainability over speed
|
|
478
450
|
6. Consider both backend and frontend implications
|
|
479
|
-
|
|
480
|
-
---
|
|
481
|
-
|
|
451
|
+
---
|
|
482
452
|
**Remember:** These rules exist to maintain quality, security, and consistency. Following them makes the codebase better for everyone.
|
|
483
453
|
|
|
484
454
|
**Last Updated:** {{GENERATION_DATE}}
|
|
485
455
|
|
|
486
456
|
**Generated by:** AI Flow v1.3.0
|
|
487
457
|
|
|
458
|
+
|
|
459
|
+
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
# Project Brief
|
|
2
2
|
|
|
3
3
|
> Business context and objectives for {{PROJECT_NAME}}
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## ๐ฏ Project Overview
|
|
8
6
|
|
|
9
7
|
### What Problem Are We Solving?
|
|
@@ -15,9 +13,7 @@
|
|
|
15
13
|
{{PROJECT_DESCRIPTION}}
|
|
16
14
|
|
|
17
15
|
**Project Type:** Full Stack Application (Backend API + Frontend Application)
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
16
|
+
---
|
|
21
17
|
## ๐ฅ Target Users
|
|
22
18
|
|
|
23
19
|
{{TARGET_USERS_DESCRIPTION}}
|
|
@@ -26,9 +22,7 @@
|
|
|
26
22
|
{{#EACH TARGET_USER}}
|
|
27
23
|
- **{{USER_TYPE}}**: {{USER_DESCRIPTION}}
|
|
28
24
|
{{/EACH}}
|
|
29
|
-
|
|
30
|
-
---
|
|
31
|
-
|
|
25
|
+
---
|
|
32
26
|
## ๐ฏ Business Objectives
|
|
33
27
|
|
|
34
28
|
### Primary Objectives
|
|
@@ -38,9 +32,7 @@
|
|
|
38
32
|
- {{OBJECTIVE_DESCRIPTION}}
|
|
39
33
|
- Success metric: {{SUCCESS_METRIC}}
|
|
40
34
|
{{/EACH}}
|
|
41
|
-
|
|
42
|
-
---
|
|
43
|
-
|
|
35
|
+
---
|
|
44
36
|
## โ
Scope
|
|
45
37
|
|
|
46
38
|
### In Scope
|
|
@@ -61,9 +53,7 @@
|
|
|
61
53
|
{{#EACH OUT_OF_SCOPE_FEATURE}}
|
|
62
54
|
- **{{FEATURE_NAME}}**: {{REASON_OUT_OF_SCOPE}}
|
|
63
55
|
{{/EACH}}
|
|
64
|
-
|
|
65
|
-
---
|
|
66
|
-
|
|
56
|
+
---
|
|
67
57
|
## ๐ง Constraints
|
|
68
58
|
|
|
69
59
|
{{#EACH CONSTRAINT}}
|
|
@@ -74,9 +64,7 @@
|
|
|
74
64
|
**Impact:** {{CONSTRAINT_IMPACT}}
|
|
75
65
|
|
|
76
66
|
{{/EACH}}
|
|
77
|
-
|
|
78
|
-
---
|
|
79
|
-
|
|
67
|
+
---
|
|
80
68
|
## ๐ Success Metrics (KPIs)
|
|
81
69
|
|
|
82
70
|
### Technical Metrics
|
|
@@ -96,9 +84,7 @@
|
|
|
96
84
|
{{#EACH BUSINESS_METRIC}}
|
|
97
85
|
- **{{METRIC_NAME}}**: {{METRIC_TARGET}}
|
|
98
86
|
{{/EACH}}
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
87
|
+
---
|
|
102
88
|
## ๐๏ธ Project Context
|
|
103
89
|
|
|
104
90
|
**Current Phase:** {{PROJECT_PHASE}}
|
|
@@ -106,17 +92,13 @@
|
|
|
106
92
|
{{#IF TIMELINE}}**Estimated Timeline:** {{TIMELINE}}{{/IF}}
|
|
107
93
|
|
|
108
94
|
{{#IF BUDGET}}**Budget Constraints:** {{BUDGET}}{{/IF}}
|
|
109
|
-
|
|
110
|
-
---
|
|
111
|
-
|
|
95
|
+
---
|
|
112
96
|
## ๐ข Stakeholders
|
|
113
97
|
|
|
114
98
|
{{#EACH STAKEHOLDER}}
|
|
115
99
|
- **{{STAKEHOLDER_ROLE}}**: {{STAKEHOLDER_INTEREST}}
|
|
116
100
|
{{/EACH}}
|
|
117
|
-
|
|
118
|
-
---
|
|
119
|
-
|
|
101
|
+
---
|
|
120
102
|
## ๐ Integration Points
|
|
121
103
|
|
|
122
104
|
**Backend External Systems:**
|
|
@@ -140,17 +122,13 @@ None - Frontend only consumes backend API.
|
|
|
140
122
|
- Critical: {{IS_CRITICAL}}
|
|
141
123
|
{{/EACH}}
|
|
142
124
|
{{/IF}}
|
|
143
|
-
|
|
144
|
-
---
|
|
145
|
-
|
|
125
|
+
---
|
|
146
126
|
## ๐ Key Assumptions
|
|
147
127
|
|
|
148
128
|
{{#EACH ASSUMPTION}}
|
|
149
129
|
- {{ASSUMPTION_DESCRIPTION}}
|
|
150
130
|
{{/EACH}}
|
|
151
|
-
|
|
152
|
-
---
|
|
153
|
-
|
|
131
|
+
---
|
|
154
132
|
## โ ๏ธ Risks
|
|
155
133
|
|
|
156
134
|
{{#EACH RISK}}
|
|
@@ -165,18 +143,14 @@ None - Frontend only consumes backend API.
|
|
|
165
143
|
**Mitigation:** {{RISK_MITIGATION}}
|
|
166
144
|
|
|
167
145
|
{{/EACH}}
|
|
168
|
-
|
|
169
|
-
---
|
|
170
|
-
|
|
146
|
+
---
|
|
171
147
|
## ๐ Domain Glossary
|
|
172
148
|
|
|
173
149
|
**Key terms and concepts:**
|
|
174
150
|
{{#EACH GLOSSARY_TERM}}
|
|
175
151
|
- **{{TERM}}**: {{DEFINITION}}
|
|
176
152
|
{{/EACH}}
|
|
177
|
-
|
|
178
|
-
---
|
|
179
|
-
|
|
153
|
+
---
|
|
180
154
|
## ๐ References
|
|
181
155
|
|
|
182
156
|
{{#IF REFERENCES}}
|
|
@@ -186,12 +160,12 @@ None - Frontend only consumes backend API.
|
|
|
186
160
|
{{ELSE}}
|
|
187
161
|
No external references.
|
|
188
162
|
{{/IF}}
|
|
189
|
-
|
|
190
|
-
---
|
|
191
|
-
|
|
163
|
+
---
|
|
192
164
|
**Document Version:** 1.0
|
|
193
165
|
|
|
194
166
|
**Last Updated:** {{GENERATION_DATE}}
|
|
195
167
|
|
|
196
168
|
**Generated by:** AI Flow v1.3.0
|
|
197
169
|
|
|
170
|
+
|
|
171
|
+
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
# Configuration Specifications
|
|
2
2
|
|
|
3
3
|
> Environment variables and configuration management for {{PROJECT_NAME}} (Full Stack)
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## ๐ฏ Configuration Strategy
|
|
8
6
|
|
|
9
7
|
**Approach:** {{CONFIGURATION_APPROACH}}
|
|
@@ -13,9 +11,7 @@
|
|
|
13
11
|
2. **Security First** - Never expose secrets to client
|
|
14
12
|
3. **Type Safety** - Validate and type all config
|
|
15
13
|
4. **Environment Parity** - Consistent config across environments
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
14
|
+
---
|
|
19
15
|
## ๐ Configuration Files Structure
|
|
20
16
|
|
|
21
17
|
```
|
|
@@ -36,9 +32,7 @@
|
|
|
36
32
|
โ โโโ schema.ts # Validation schema
|
|
37
33
|
โ โโโ constants.ts # Static constants
|
|
38
34
|
```
|
|
39
|
-
|
|
40
|
-
---
|
|
41
|
-
|
|
35
|
+
---
|
|
42
36
|
## ๐ Backend Environment Variables
|
|
43
37
|
|
|
44
38
|
### Required Variables
|
|
@@ -70,9 +64,7 @@
|
|
|
70
64
|
**Example:** `{{VAR_EXAMPLE}}`
|
|
71
65
|
|
|
72
66
|
{{/EACH}}
|
|
73
|
-
|
|
74
|
-
---
|
|
75
|
-
|
|
67
|
+
---
|
|
76
68
|
## ๐จ Frontend Environment Variables
|
|
77
69
|
|
|
78
70
|
### Required Variables
|
|
@@ -119,9 +111,7 @@
|
|
|
119
111
|
- `VITE_ANALYTICS_*` - Analytics services
|
|
120
112
|
|
|
121
113
|
**Important:** Only variables prefixed with `VITE_` (or your build tool's prefix) are exposed to the client.
|
|
122
|
-
|
|
123
|
-
---
|
|
124
|
-
|
|
114
|
+
---
|
|
125
115
|
## ๐ Configuration by Environment
|
|
126
116
|
|
|
127
117
|
### Development
|
|
@@ -159,9 +149,7 @@
|
|
|
159
149
|
```bash
|
|
160
150
|
{{FRONTEND_PRODUCTION_ENV_CONFIG}}
|
|
161
151
|
```
|
|
162
|
-
|
|
163
|
-
---
|
|
164
|
-
|
|
152
|
+
---
|
|
165
153
|
## ๐ External Services
|
|
166
154
|
|
|
167
155
|
### Backend Services
|
|
@@ -199,9 +187,7 @@
|
|
|
199
187
|
{{#IF SERVICE_FALLBACK}}**Fallback:** {{SERVICE_FALLBACK}}{{/IF}}
|
|
200
188
|
|
|
201
189
|
{{/EACH}}
|
|
202
|
-
|
|
203
|
-
---
|
|
204
|
-
|
|
190
|
+
---
|
|
205
191
|
## ๐พ Database Configuration (Backend)
|
|
206
192
|
|
|
207
193
|
```bash
|
|
@@ -212,9 +198,7 @@
|
|
|
212
198
|
- Min: {{DB_POOL_MIN}}
|
|
213
199
|
- Max: {{DB_POOL_MAX}}
|
|
214
200
|
- Idle Timeout: {{DB_IDLE_TIMEOUT}}ms
|
|
215
|
-
|
|
216
|
-
---
|
|
217
|
-
|
|
201
|
+
---
|
|
218
202
|
## ๐ Secrets Management
|
|
219
203
|
|
|
220
204
|
### Backend Secrets
|
|
@@ -242,9 +226,7 @@
|
|
|
242
226
|
- API secret keys
|
|
243
227
|
- Authentication secrets
|
|
244
228
|
- Private keys
|
|
245
|
-
|
|
246
|
-
---
|
|
247
|
-
|
|
229
|
+
---
|
|
248
230
|
## ๐ฉ Feature Flags
|
|
249
231
|
|
|
250
232
|
### Backend Feature Flags
|
|
@@ -284,9 +266,7 @@ Backend feature flags not implemented yet.
|
|
|
284
266
|
Frontend feature flags not implemented yet.
|
|
285
267
|
|
|
286
268
|
{{/IF}}
|
|
287
|
-
|
|
288
|
-
---
|
|
289
|
-
|
|
269
|
+
---
|
|
290
270
|
## ๐ Security Best Practices
|
|
291
271
|
|
|
292
272
|
### Backend
|
|
@@ -318,9 +298,7 @@ VITE_STRIPE_PUBLISHABLE_KEY=pk_live_...
|
|
|
318
298
|
# Backend
|
|
319
299
|
STRIPE_SECRET_KEY=sk_live_...
|
|
320
300
|
```
|
|
321
|
-
|
|
322
|
-
---
|
|
323
|
-
|
|
301
|
+
---
|
|
324
302
|
## ๐งช Testing Configuration
|
|
325
303
|
|
|
326
304
|
### Backend Test Environment
|
|
@@ -345,9 +323,7 @@ export default defineConfig({
|
|
|
345
323
|
},
|
|
346
324
|
});
|
|
347
325
|
```
|
|
348
|
-
|
|
349
|
-
---
|
|
350
|
-
|
|
326
|
+
---
|
|
351
327
|
## ๐ Configuration Monitoring
|
|
352
328
|
|
|
353
329
|
### Backend
|
|
@@ -361,20 +337,18 @@ export default defineConfig({
|
|
|
361
337
|
- Log config on startup (development only)
|
|
362
338
|
- Monitor API endpoint availability
|
|
363
339
|
- Track feature flag usage
|
|
364
|
-
|
|
365
|
-
---
|
|
366
|
-
|
|
340
|
+
---
|
|
367
341
|
## ๐ Related Documents
|
|
368
342
|
|
|
369
343
|
- [AI Instructions](../ai-instructions.md) - Configuration rules
|
|
370
344
|
- [Security Specification](security.md) - Security requirements
|
|
371
345
|
- [Deployment Guide](../docs/operations.md) - Environment setup
|
|
372
|
-
|
|
373
|
-
---
|
|
374
|
-
|
|
346
|
+
---
|
|
375
347
|
**Document Version:** 1.0
|
|
376
348
|
|
|
377
349
|
**Last Updated:** {{GENERATION_DATE}}
|
|
378
350
|
|
|
379
351
|
**Generated by:** AI Flow v1.3.0
|
|
380
352
|
|
|
353
|
+
|
|
354
|
+
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
# {{PROJECT_NAME}}
|
|
2
2
|
|
|
3
3
|
> {{PROJECT_DESCRIPTION}}
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## ๐ Quick Start
|
|
8
6
|
|
|
9
7
|
### Prerequisites
|
|
@@ -56,17 +54,13 @@ cp .env.example .env
|
|
|
56
54
|
```
|
|
57
55
|
|
|
58
56
|
See `specs/configuration.md` for all environment variables.
|
|
59
|
-
|
|
60
|
-
---
|
|
61
|
-
|
|
57
|
+
---
|
|
62
58
|
## ๐ Project Structure
|
|
63
59
|
|
|
64
60
|
```
|
|
65
61
|
{{FOLDER_STRUCTURE}}
|
|
66
62
|
```
|
|
67
|
-
|
|
68
|
-
---
|
|
69
|
-
|
|
63
|
+
---
|
|
70
64
|
## ๐ ๏ธ Development
|
|
71
65
|
|
|
72
66
|
### Available Scripts
|
|
@@ -89,9 +83,7 @@ See `specs/configuration.md` for all environment variables.
|
|
|
89
83
|
- **Testing:** {{UNIT_TEST_FRAMEWORK}}, {{E2E_FRAMEWORK}}
|
|
90
84
|
|
|
91
85
|
See `ai-instructions.md` for complete tech stack.
|
|
92
|
-
|
|
93
|
-
---
|
|
94
|
-
|
|
86
|
+
---
|
|
95
87
|
## ๐ Documentation
|
|
96
88
|
|
|
97
89
|
**For AI Assistants:**
|
|
@@ -109,9 +101,7 @@ See `ai-instructions.md` for complete tech stack.
|
|
|
109
101
|
- `docs/app-store.md` - App Store configuration
|
|
110
102
|
- `specs/build-configuration.md` - Build configuration
|
|
111
103
|
- `specs/deployment.md` - Deployment procedures
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
104
|
+
---
|
|
115
105
|
## ๐งช Testing
|
|
116
106
|
|
|
117
107
|
```bash
|
|
@@ -128,9 +118,7 @@ See `ai-instructions.md` for complete tech stack.
|
|
|
128
118
|
{{PACKAGE_MANAGER}} run ios --device
|
|
129
119
|
{{PACKAGE_MANAGER}} run android --device
|
|
130
120
|
```
|
|
131
|
-
|
|
132
|
-
---
|
|
133
|
-
|
|
121
|
+
---
|
|
134
122
|
## ๐ฑ Building for Production
|
|
135
123
|
|
|
136
124
|
### iOS
|
|
@@ -156,9 +144,7 @@ See `ai-instructions.md` for complete tech stack.
|
|
|
156
144
|
```
|
|
157
145
|
|
|
158
146
|
See `specs/deployment.md` for detailed deployment instructions.
|
|
159
|
-
|
|
160
|
-
---
|
|
161
|
-
|
|
147
|
+
---
|
|
162
148
|
## ๐ Deployment
|
|
163
149
|
|
|
164
150
|
### App Store (iOS)
|
|
@@ -176,20 +162,16 @@ See `docs/app-store.md` for detailed instructions.
|
|
|
176
162
|
3. Submit for review
|
|
177
163
|
|
|
178
164
|
See `docs/app-store.md` for detailed instructions.
|
|
179
|
-
|
|
180
|
-
---
|
|
181
|
-
|
|
165
|
+
---
|
|
182
166
|
## ๐ License
|
|
183
167
|
|
|
184
168
|
{{LICENSE}}
|
|
185
|
-
|
|
186
|
-
---
|
|
187
|
-
|
|
169
|
+
---
|
|
188
170
|
## ๐ค Contributing
|
|
189
171
|
|
|
190
172
|
See `docs/contributing.md` for contribution guidelines.
|
|
173
|
+
---
|
|
174
|
+
**Last Updated:** {{LAST_UPDATED}}
|
|
191
175
|
|
|
192
|
-
---
|
|
193
176
|
|
|
194
|
-
**Last Updated:** {{LAST_UPDATED}}
|
|
195
177
|
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
# AI Instructions - Mobile
|
|
2
2
|
|
|
3
3
|
> **CRITICAL:** Every AI assistant MUST read and follow this document before any work.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## ๐ฏ Project Overview
|
|
8
6
|
|
|
9
7
|
**Name:** {{PROJECT_NAME}}
|
|
@@ -13,9 +11,7 @@
|
|
|
13
11
|
**Purpose:** {{PROBLEM_STATEMENT}}
|
|
14
12
|
|
|
15
13
|
**Target Users:** {{TARGET_USERS}}
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
14
|
+
---
|
|
19
15
|
## ๐๏ธ Tech Stack
|
|
20
16
|
|
|
21
17
|
### Mobile Platform
|
|
@@ -67,9 +63,7 @@
|
|
|
67
63
|
- **Versioning:** {{VERSIONING_STRATEGY}}
|
|
68
64
|
- **Analytics:** {{ANALYTICS_TOOL}}
|
|
69
65
|
- **Crash Reporting:** {{CRASH_REPORTING_TOOL}}
|
|
70
|
-
|
|
71
|
-
---
|
|
72
|
-
|
|
66
|
+
---
|
|
73
67
|
## ๐๏ธ Architecture
|
|
74
68
|
|
|
75
69
|
**Architecture Pattern:** {{ARCHITECTURE_PATTERN}}
|
|
@@ -82,9 +76,7 @@
|
|
|
82
76
|
```
|
|
83
77
|
{{FOLDER_STRUCTURE}}
|
|
84
78
|
```
|
|
85
|
-
|
|
86
|
-
---
|
|
87
|
-
|
|
79
|
+
---
|
|
88
80
|
## โ NEVER Rules
|
|
89
81
|
|
|
90
82
|
**YOU MUST NEVER:**
|
|
@@ -119,9 +111,7 @@
|
|
|
119
111
|
- โ Assume iOS and Android are identical - Handle platform-specific code
|
|
120
112
|
- โ Use platform-specific APIs without checks - Check platform before using
|
|
121
113
|
- โ Ignore platform guidelines - Follow iOS Human Interface Guidelines and Material Design
|
|
122
|
-
|
|
123
|
-
---
|
|
124
|
-
|
|
114
|
+
---
|
|
125
115
|
## โ
ALWAYS Rules
|
|
126
116
|
|
|
127
117
|
**YOU MUST ALWAYS:**
|
|
@@ -161,9 +151,7 @@
|
|
|
161
151
|
- โ
Test on multiple screen sizes
|
|
162
152
|
- โ
Test offline scenarios
|
|
163
153
|
- โ
Test permission flows
|
|
164
|
-
|
|
165
|
-
---
|
|
166
|
-
|
|
154
|
+
---
|
|
167
155
|
## ๐ฑ Mobile-Specific Guidelines
|
|
168
156
|
|
|
169
157
|
### iOS
|
|
@@ -188,9 +176,7 @@
|
|
|
188
176
|
- โ
Test on both platforms
|
|
189
177
|
- โ
Handle platform differences gracefully
|
|
190
178
|
- โ
Use platform detection utilities
|
|
191
|
-
|
|
192
|
-
---
|
|
193
|
-
|
|
179
|
+
---
|
|
194
180
|
## ๐ Development Workflow
|
|
195
181
|
|
|
196
182
|
1. **Read this file first** - Understand tech stack and rules
|
|
@@ -199,9 +185,7 @@
|
|
|
199
185
|
4. **Test on devices** - Not just simulators
|
|
200
186
|
5. **Handle errors** - Graceful error handling
|
|
201
187
|
6. **Optimize performance** - Monitor and optimize
|
|
202
|
-
|
|
203
|
-
---
|
|
204
|
-
|
|
188
|
+
---
|
|
205
189
|
## ๐ Key Documentation
|
|
206
190
|
|
|
207
191
|
- `AGENT.md` - Universal AI context
|
|
@@ -212,10 +196,10 @@
|
|
|
212
196
|
- `docs/permissions.md` - Permissions handling
|
|
213
197
|
- `docs/testing.md` - Testing strategy
|
|
214
198
|
- `docs/app-store.md` - App Store deployment
|
|
215
|
-
|
|
216
|
-
---
|
|
217
|
-
|
|
199
|
+
---
|
|
218
200
|
**Last Updated:** {{LAST_UPDATED}}
|
|
219
201
|
|
|
220
202
|
**Version:** {{PROJECT_VERSION}}
|
|
221
203
|
|
|
204
|
+
|
|
205
|
+
|