ai-flow-dev 2.5.4 β†’ 2.7.0

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 (163) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +570 -567
  3. package/dist/cli.js +30 -2
  4. package/dist/cli.js.map +1 -1
  5. package/package.json +73 -73
  6. package/prompts/backend/flow-build-phase-0.md +535 -425
  7. package/prompts/backend/flow-build-phase-1.md +626 -626
  8. package/prompts/backend/flow-build-phase-10.md +340 -340
  9. package/prompts/backend/flow-build-phase-2.md +573 -573
  10. package/prompts/backend/flow-build-phase-3.md +834 -782
  11. package/prompts/backend/flow-build-phase-4.md +554 -554
  12. package/prompts/backend/flow-build-phase-5.md +703 -703
  13. package/prompts/backend/flow-build-phase-6.md +524 -524
  14. package/prompts/backend/flow-build-phase-7.md +1001 -1001
  15. package/prompts/backend/flow-build-phase-8.md +1407 -1407
  16. package/prompts/backend/flow-build-phase-9.md +477 -477
  17. package/prompts/backend/flow-build.md +137 -137
  18. package/prompts/backend/flow-check-review.md +20 -20
  19. package/prompts/backend/flow-check-test.md +14 -14
  20. package/prompts/backend/flow-check.md +67 -67
  21. package/prompts/backend/flow-commit.md +119 -119
  22. package/prompts/backend/flow-docs-sync.md +354 -354
  23. package/prompts/backend/flow-work-feature.md +61 -61
  24. package/prompts/backend/flow-work-fix.md +46 -46
  25. package/prompts/backend/flow-work-refactor.md +48 -48
  26. package/prompts/backend/flow-work-resume.md +34 -34
  27. package/prompts/backend/flow-work.md +1286 -1023
  28. package/prompts/desktop/flow-build-phase-0.md +359 -0
  29. package/prompts/desktop/flow-build-phase-1.md +295 -0
  30. package/prompts/desktop/flow-build-phase-10.md +357 -0
  31. package/prompts/desktop/flow-build-phase-2.md +282 -0
  32. package/prompts/desktop/flow-build-phase-3.md +291 -0
  33. package/prompts/desktop/flow-build-phase-4.md +308 -0
  34. package/prompts/desktop/flow-build-phase-5.md +269 -0
  35. package/prompts/desktop/flow-build-phase-6.md +350 -0
  36. package/prompts/desktop/flow-build-phase-7.md +297 -0
  37. package/prompts/desktop/flow-build-phase-8.md +541 -0
  38. package/prompts/desktop/flow-build-phase-9.md +439 -0
  39. package/prompts/desktop/flow-build.md +156 -0
  40. package/prompts/desktop/flow-check-review.md +20 -0
  41. package/prompts/desktop/flow-check-test.md +14 -0
  42. package/prompts/desktop/flow-check.md +67 -0
  43. package/prompts/desktop/flow-commit.md +119 -0
  44. package/prompts/desktop/flow-docs-sync.md +354 -0
  45. package/prompts/desktop/flow-work-feature.md +61 -0
  46. package/prompts/desktop/flow-work-fix.md +46 -0
  47. package/prompts/desktop/flow-work-refactor.md +48 -0
  48. package/prompts/desktop/flow-work-resume.md +34 -0
  49. package/prompts/desktop/flow-work.md +1390 -0
  50. package/prompts/frontend/flow-build-phase-0.md +425 -425
  51. package/prompts/frontend/flow-build-phase-1.md +626 -626
  52. package/prompts/frontend/flow-build-phase-10.md +33 -33
  53. package/prompts/frontend/flow-build-phase-2.md +573 -573
  54. package/prompts/frontend/flow-build-phase-3.md +782 -782
  55. package/prompts/frontend/flow-build-phase-4.md +554 -554
  56. package/prompts/frontend/flow-build-phase-5.md +703 -703
  57. package/prompts/frontend/flow-build-phase-6.md +524 -524
  58. package/prompts/frontend/flow-build-phase-7.md +1001 -1001
  59. package/prompts/frontend/flow-build-phase-8.md +872 -872
  60. package/prompts/frontend/flow-build-phase-9.md +94 -94
  61. package/prompts/frontend/flow-build.md +137 -137
  62. package/prompts/frontend/flow-check-review.md +20 -20
  63. package/prompts/frontend/flow-check-test.md +14 -14
  64. package/prompts/frontend/flow-check.md +67 -67
  65. package/prompts/frontend/flow-commit.md +119 -119
  66. package/prompts/frontend/flow-docs-sync.md +550 -550
  67. package/prompts/frontend/flow-work-feature.md +61 -61
  68. package/prompts/frontend/flow-work-fix.md +38 -38
  69. package/prompts/frontend/flow-work-refactor.md +48 -48
  70. package/prompts/frontend/flow-work-resume.md +34 -34
  71. package/prompts/frontend/flow-work.md +1320 -1027
  72. package/prompts/mobile/flow-build-phase-0.md +425 -425
  73. package/prompts/mobile/flow-build-phase-1.md +626 -626
  74. package/prompts/mobile/flow-build-phase-10.md +32 -32
  75. package/prompts/mobile/flow-build-phase-2.md +573 -573
  76. package/prompts/mobile/flow-build-phase-3.md +782 -782
  77. package/prompts/mobile/flow-build-phase-4.md +554 -554
  78. package/prompts/mobile/flow-build-phase-5.md +703 -703
  79. package/prompts/mobile/flow-build-phase-6.md +524 -524
  80. package/prompts/mobile/flow-build-phase-7.md +1001 -1001
  81. package/prompts/mobile/flow-build-phase-8.md +888 -888
  82. package/prompts/mobile/flow-build-phase-9.md +90 -90
  83. package/prompts/mobile/flow-build.md +135 -135
  84. package/prompts/mobile/flow-check-review.md +20 -20
  85. package/prompts/mobile/flow-check-test.md +14 -14
  86. package/prompts/mobile/flow-check.md +67 -67
  87. package/prompts/mobile/flow-commit.md +119 -119
  88. package/prompts/mobile/flow-docs-sync.md +620 -620
  89. package/prompts/mobile/flow-work-feature.md +61 -61
  90. package/prompts/mobile/flow-work-fix.md +46 -46
  91. package/prompts/mobile/flow-work-refactor.md +48 -48
  92. package/prompts/mobile/flow-work-resume.md +34 -34
  93. package/prompts/mobile/flow-work.md +1329 -1023
  94. package/prompts/shared/mermaid-guidelines.md +102 -102
  95. package/prompts/shared/scope-levels.md +114 -114
  96. package/prompts/shared/smart-skip-preflight.md +214 -214
  97. package/prompts/shared/story-points.md +55 -55
  98. package/prompts/shared/task-format.md +74 -74
  99. package/prompts/shared/task-summary-template.md +277 -277
  100. package/templates/AGENT.template.md +443 -443
  101. package/templates/backend/.clauderules.template +112 -112
  102. package/templates/backend/.cursorrules.template +102 -102
  103. package/templates/backend/README.template.md +2 -2
  104. package/templates/backend/ai-instructions.template.md +2 -2
  105. package/templates/backend/copilot-instructions.template.md +2 -2
  106. package/templates/backend/docs/api.template.md +320 -320
  107. package/templates/backend/docs/business-flows.template.md +97 -97
  108. package/templates/backend/docs/code-standards.template.md +2 -2
  109. package/templates/backend/docs/contributing.template.md +3 -3
  110. package/templates/backend/docs/data-model.template.md +520 -520
  111. package/templates/backend/docs/testing.template.md +2 -2
  112. package/templates/backend/project-brief.template.md +2 -2
  113. package/templates/backend/specs/configuration.template.md +2 -2
  114. package/templates/backend/specs/security.template.md +2 -2
  115. package/templates/desktop/.clauderules.template +112 -0
  116. package/templates/desktop/.cursorrules.template +102 -0
  117. package/templates/desktop/README.template.md +170 -0
  118. package/templates/desktop/ai-instructions.template.md +366 -0
  119. package/templates/desktop/copilot-instructions.template.md +140 -0
  120. package/templates/desktop/docs/docs/api.template.md +320 -0
  121. package/templates/desktop/docs/docs/architecture.template.md +724 -0
  122. package/templates/desktop/docs/docs/business-flows.template.md +102 -0
  123. package/templates/desktop/docs/docs/code-standards.template.md +792 -0
  124. package/templates/desktop/docs/docs/contributing.template.md +149 -0
  125. package/templates/desktop/docs/docs/data-model.template.md +520 -0
  126. package/templates/desktop/docs/docs/operations.template.md +720 -0
  127. package/templates/desktop/docs/docs/testing.template.md +722 -0
  128. package/templates/desktop/project-brief.template.md +150 -0
  129. package/templates/desktop/specs/specs/configuration.template.md +121 -0
  130. package/templates/desktop/specs/specs/security.template.md +392 -0
  131. package/templates/frontend/README.template.md +2 -2
  132. package/templates/frontend/ai-instructions.template.md +2 -2
  133. package/templates/frontend/docs/api-integration.template.md +362 -362
  134. package/templates/frontend/docs/components.template.md +2 -2
  135. package/templates/frontend/docs/error-handling.template.md +360 -360
  136. package/templates/frontend/docs/operations.template.md +107 -107
  137. package/templates/frontend/docs/performance.template.md +124 -124
  138. package/templates/frontend/docs/pwa.template.md +119 -119
  139. package/templates/frontend/docs/state-management.template.md +2 -2
  140. package/templates/frontend/docs/styling.template.md +2 -2
  141. package/templates/frontend/docs/testing.template.md +2 -2
  142. package/templates/frontend/project-brief.template.md +2 -2
  143. package/templates/frontend/specs/accessibility.template.md +95 -95
  144. package/templates/frontend/specs/configuration.template.md +2 -2
  145. package/templates/frontend/specs/security.template.md +175 -175
  146. package/templates/fullstack/README.template.md +252 -252
  147. package/templates/fullstack/ai-instructions.template.md +444 -444
  148. package/templates/fullstack/project-brief.template.md +157 -157
  149. package/templates/fullstack/specs/configuration.template.md +340 -340
  150. package/templates/mobile/README.template.md +167 -167
  151. package/templates/mobile/ai-instructions.template.md +196 -196
  152. package/templates/mobile/docs/app-store.template.md +135 -135
  153. package/templates/mobile/docs/architecture.template.md +63 -63
  154. package/templates/mobile/docs/native-features.template.md +94 -94
  155. package/templates/mobile/docs/navigation.template.md +59 -59
  156. package/templates/mobile/docs/offline-strategy.template.md +65 -65
  157. package/templates/mobile/docs/permissions.template.md +56 -56
  158. package/templates/mobile/docs/state-management.template.md +85 -85
  159. package/templates/mobile/docs/testing.template.md +109 -109
  160. package/templates/mobile/project-brief.template.md +69 -69
  161. package/templates/mobile/specs/build-configuration.template.md +91 -91
  162. package/templates/mobile/specs/deployment.template.md +92 -92
  163. package/templates/work.template.md +47 -47
@@ -1,61 +1,61 @@
1
- ---
2
- description: Internal logic for Feature implementation within flow-work
3
- ---
4
-
5
- # AI Flow - Feature Logic
6
-
7
- This file contains the detailed execution logic for implementing new features, imported by `@flow-work.md`.
8
-
9
- ---
10
-
11
- ## πŸš€ Feature Implementation Flow
12
-
13
- ### 1. Context Analysis (auto-skip if User Story with detailed tasks)
14
-
15
- - Extract requirements from User Story or Roadmap
16
- - If User Story has detailed tasks: Skip to work.md generation
17
- - If Roadmap or Manual: Analyze and refine
18
- - Read relevant documentation (ai-instructions.md, architecture.md, etc.)
19
-
20
- ### 2. work.md Generation
21
-
22
- - Generate consolidated work.md (see Phase 2 in flow-work.md)
23
- - Include: Context, Objective, Constraints, Approach, Tasks, Validation
24
- - **User Confirmation Required**
25
-
26
- ### 3. Progressive Implementation
27
-
28
- Choose mode:
29
-
30
- - **Auto**: Complete all tasks without pausing
31
- - **Phase-by-phase**: Pause and validate after each phase
32
- - **Task-by-task**: Pause after each task
33
-
34
- Follow tasks in `work.md`:
35
-
36
- - Update checkboxes as completed
37
- - Update `status.json` progress
38
- - Follow patterns and constraints specified
39
-
40
- ### 4. Definition of Done (DoD)
41
-
42
- - If HU mode: Validate against Gherkin scenarios
43
- - Run tests and linting
44
- - Perform security check
45
- - **Update completion status** in source documents (see Phase 4 in flow-work.md)
46
-
47
- ---
48
-
49
- ## 🌿 Git Branching Strategy
50
-
51
- - Generate slug from name
52
- - Execute `git checkout -b feature/[slug]`
53
- - **Note:** Creating feature branches FROM `main`/`master`/`develop`/`development` is correct workflow
54
- - **Never commit directly TO protected branches** - always work on feature branch
55
- - Maintain `status.json` with commit history
56
-
57
- ---
58
-
59
- ## πŸ“¦ status.json Persistence
60
-
61
- Ensure `progress`, `git`, and `metadata` sections are always updated.
1
+ ---
2
+ description: Internal logic for Feature implementation within flow-work
3
+ ---
4
+
5
+ # AI Flow - Feature Logic
6
+
7
+ This file contains the detailed execution logic for implementing new features, imported by `@flow-work.md`.
8
+
9
+ ---
10
+
11
+ ## πŸš€ Feature Implementation Flow
12
+
13
+ ### 1. Context Analysis (auto-skip if User Story with detailed tasks)
14
+
15
+ - Extract requirements from User Story or Roadmap
16
+ - If User Story has detailed tasks: Skip to work.md generation
17
+ - If Roadmap or Manual: Analyze and refine
18
+ - Read relevant documentation (ai-instructions.md, architecture.md, etc.)
19
+
20
+ ### 2. work.md Generation
21
+
22
+ - Generate consolidated work.md (see Phase 2 in flow-work.md)
23
+ - Include: Context, Objective, Constraints, Approach, Tasks, Validation
24
+ - **User Confirmation Required**
25
+
26
+ ### 3. Progressive Implementation
27
+
28
+ Choose mode:
29
+
30
+ - **Auto**: Complete all tasks without pausing
31
+ - **Phase-by-phase**: Pause and validate after each phase
32
+ - **Task-by-task**: Pause after each task
33
+
34
+ Follow tasks in `work.md`:
35
+
36
+ - Update checkboxes as completed
37
+ - Update `status.json` progress
38
+ - Follow patterns and constraints specified
39
+
40
+ ### 4. Definition of Done (DoD)
41
+
42
+ - If HU mode: Validate against Gherkin scenarios
43
+ - Run tests and linting
44
+ - Perform security check
45
+ - **Update completion status** in source documents (see Phase 4 in flow-work.md)
46
+
47
+ ---
48
+
49
+ ## 🌿 Git Branching Strategy
50
+
51
+ - Generate slug from name
52
+ - Execute `git checkout -b feature/[slug]`
53
+ - **Note:** Creating feature branches FROM `main`/`master`/`develop`/`development` is correct workflow
54
+ - **Never commit directly TO protected branches** - always work on feature branch
55
+ - Maintain `status.json` with commit history
56
+
57
+ ---
58
+
59
+ ## πŸ“¦ status.json Persistence
60
+
61
+ Ensure `progress`, `git`, and `metadata` sections are always updated.
@@ -1,46 +1,46 @@
1
- ---
2
- description: Internal logic for Bug Fixes within flow-work
3
- ---
4
-
5
- # AI Flow - Fix Logic
6
-
7
- This file contains the detailed execution logic for bug fixes, imported by `@flow-work.md`.
8
-
9
- ---
10
-
11
- ## πŸ”§ Bug Fix Workflow
12
-
13
- ### 1. Classification
14
-
15
- - **QUICK**: 1 file, obvious cause (typo, null check)
16
- - **COMPLEX**: Multiple files, investigation needed
17
-
18
- ### 2. Analysis & work.md Generation
19
-
20
- - **QUICK**: Minimal work.md (objective + 1-2 tasks)
21
- - **COMPLEX**: Full work.md with root cause analysis
22
- - Document root cause in Objective section
23
- - Map side effects in Approach section
24
- - Generate detailed tasks
25
-
26
- ### 3. Implementation
27
-
28
- - **Test-First Approach**: Add failing test that reproduces bug
29
- - Apply the fix following work.md tasks
30
- - Verify tests pass
31
- - **Update completion status** if fix was tracked in roadmap/user stories (see Phase 4 in flow-work.md)
32
-
33
- ---
34
-
35
- ## 🌿 Git Branching Strategy
36
-
37
- - **QUICK**: Usually work on current branch
38
- - ⚠️ **Exception:** If on protected branch (`main`, `master`, `develop`, `development`), create fix branch even for quick fixes
39
- - **COMPLEX**: Execute `git checkout -b fix/[slug]`
40
- - **Never commit directly TO protected branches**
41
-
42
- ---
43
-
44
- ## πŸ“¦ status.json Persistence
45
-
46
- Track root cause details and verification test status.
1
+ ---
2
+ description: Internal logic for Bug Fixes within flow-work
3
+ ---
4
+
5
+ # AI Flow - Fix Logic
6
+
7
+ This file contains the detailed execution logic for bug fixes, imported by `@flow-work.md`.
8
+
9
+ ---
10
+
11
+ ## πŸ”§ Bug Fix Workflow
12
+
13
+ ### 1. Classification
14
+
15
+ - **QUICK**: 1 file, obvious cause (typo, null check)
16
+ - **COMPLEX**: Multiple files, investigation needed
17
+
18
+ ### 2. Analysis & work.md Generation
19
+
20
+ - **QUICK**: Minimal work.md (objective + 1-2 tasks)
21
+ - **COMPLEX**: Full work.md with root cause analysis
22
+ - Document root cause in Objective section
23
+ - Map side effects in Approach section
24
+ - Generate detailed tasks
25
+
26
+ ### 3. Implementation
27
+
28
+ - **Test-First Approach**: Add failing test that reproduces bug
29
+ - Apply the fix following work.md tasks
30
+ - Verify tests pass
31
+ - **Update completion status** if fix was tracked in roadmap/user stories (see Phase 4 in flow-work.md)
32
+
33
+ ---
34
+
35
+ ## 🌿 Git Branching Strategy
36
+
37
+ - **QUICK**: Usually work on current branch
38
+ - ⚠️ **Exception:** If on protected branch (`main`, `master`, `develop`, `development`), create fix branch even for quick fixes
39
+ - **COMPLEX**: Execute `git checkout -b fix/[slug]`
40
+ - **Never commit directly TO protected branches**
41
+
42
+ ---
43
+
44
+ ## πŸ“¦ status.json Persistence
45
+
46
+ Track root cause details and verification test status.
@@ -1,48 +1,48 @@
1
- ---
2
- description: Internal logic for Refactor implementation within flow-work
3
- ---
4
-
5
- # AI Flow - Refactor Logic
6
-
7
- This file contains the detailed execution logic for code refactoring, imported by `@flow-work.md`.
8
-
9
- ---
10
-
11
- ## πŸ”„ Refactoring Workflow
12
-
13
- ### 1. Scope Identification & work.md Generation
14
-
15
- - Map affected files and dependencies
16
- - Confirm no behavior change expected
17
- - Validate against architecture patterns
18
- - Generate work.md with:
19
- - Clear scope (what to extract/move/rename)
20
- - Affected files list
21
- - Step-by-step tasks
22
- - "No behavior change" constraint
23
-
24
- ### 2. Implementation
25
-
26
- - Follow work.md tasks sequentially
27
- - Update imports and references across codebase
28
- - **Critical**: Existing tests must pass without modification (unless test itself is refactored)
29
-
30
- ### 3. Validation
31
-
32
- - Run `/flow-check` to verify no regressions
33
- - Confirm all tests pass
34
- - **Update completion status** if refactor was tracked in roadmap/user stories (see Phase 4 in flow-work.md)
35
-
36
- ---
37
-
38
- ## 🌿 Git Branching Strategy
39
-
40
- - Execute `git checkout -b refactor/[slug]`
41
- - **Note:** Creating refactor branches FROM `main`/`master`/`develop`/`development` is correct
42
- - **Never commit directly TO protected branches**
43
-
44
- ---
45
-
46
- ## πŸ“¦ status.json Persistence
47
-
48
- Track `percentage` of updated occurrences and updated file paths.
1
+ ---
2
+ description: Internal logic for Refactor implementation within flow-work
3
+ ---
4
+
5
+ # AI Flow - Refactor Logic
6
+
7
+ This file contains the detailed execution logic for code refactoring, imported by `@flow-work.md`.
8
+
9
+ ---
10
+
11
+ ## πŸ”„ Refactoring Workflow
12
+
13
+ ### 1. Scope Identification & work.md Generation
14
+
15
+ - Map affected files and dependencies
16
+ - Confirm no behavior change expected
17
+ - Validate against architecture patterns
18
+ - Generate work.md with:
19
+ - Clear scope (what to extract/move/rename)
20
+ - Affected files list
21
+ - Step-by-step tasks
22
+ - "No behavior change" constraint
23
+
24
+ ### 2. Implementation
25
+
26
+ - Follow work.md tasks sequentially
27
+ - Update imports and references across codebase
28
+ - **Critical**: Existing tests must pass without modification (unless test itself is refactored)
29
+
30
+ ### 3. Validation
31
+
32
+ - Run `/flow-check` to verify no regressions
33
+ - Confirm all tests pass
34
+ - **Update completion status** if refactor was tracked in roadmap/user stories (see Phase 4 in flow-work.md)
35
+
36
+ ---
37
+
38
+ ## 🌿 Git Branching Strategy
39
+
40
+ - Execute `git checkout -b refactor/[slug]`
41
+ - **Note:** Creating refactor branches FROM `main`/`master`/`develop`/`development` is correct
42
+ - **Never commit directly TO protected branches**
43
+
44
+ ---
45
+
46
+ ## πŸ“¦ status.json Persistence
47
+
48
+ Track `percentage` of updated occurrences and updated file paths.
@@ -1,34 +1,34 @@
1
- ---
2
- description: Internal logic for Resuming work within flow-work
3
- ---
4
-
5
- # AI Flow - Resume Logic
6
-
7
- This file contains the logic for detecting and resuming paused work items, imported by `@flow-work.md`.
8
-
9
- ---
10
- ## ⏸️ Resume Workflow
11
-
12
- ### 1. Work Detection
13
- - Scan `.ai-flow/work/` for any directories
14
- - Group by type and last updated timestamp
15
-
16
- ### 2. Selection Menu
17
- - Show active tasks with percentage and current branch
18
- - Identify current Git branch and match with work items (⭐⭐ marker)
19
-
20
- ### 3. Context Restoration
21
- - Load `work.md` and `status.json`
22
- - Verify Git branch:
23
- - If mismatch: Prompt to switch to `git.branchName`
24
- - Identify the first incomplete task in `work.md`
25
- - Read Documentation Constraints section to refresh context
26
-
27
- ### 4. Implementation Continuation
28
- - Resume with the previously saved `implementationMode`
29
- - Continue execution from where it was paused
30
- - Follow remaining tasks in `work.md`
31
-
32
- ---
33
- ## πŸ“¦ status.json Persistence
34
- Update `timestamps.lastUpdated` upon resuming.
1
+ ---
2
+ description: Internal logic for Resuming work within flow-work
3
+ ---
4
+
5
+ # AI Flow - Resume Logic
6
+
7
+ This file contains the logic for detecting and resuming paused work items, imported by `@flow-work.md`.
8
+
9
+ ---
10
+ ## ⏸️ Resume Workflow
11
+
12
+ ### 1. Work Detection
13
+ - Scan `.ai-flow/work/` for any directories
14
+ - Group by type and last updated timestamp
15
+
16
+ ### 2. Selection Menu
17
+ - Show active tasks with percentage and current branch
18
+ - Identify current Git branch and match with work items (⭐⭐ marker)
19
+
20
+ ### 3. Context Restoration
21
+ - Load `work.md` and `status.json`
22
+ - Verify Git branch:
23
+ - If mismatch: Prompt to switch to `git.branchName`
24
+ - Identify the first incomplete task in `work.md`
25
+ - Read Documentation Constraints section to refresh context
26
+
27
+ ### 4. Implementation Continuation
28
+ - Resume with the previously saved `implementationMode`
29
+ - Continue execution from where it was paused
30
+ - Follow remaining tasks in `work.md`
31
+
32
+ ---
33
+ ## πŸ“¦ status.json Persistence
34
+ Update `timestamps.lastUpdated` upon resuming.