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,67 +1,67 @@
1
- ---
2
- description: Combined Validation workflow for Tests and Code Review
3
- ---
4
-
5
- # AI Flow - Unified Check Workflow
6
-
7
- **YOU ARE AN EXPERT QUALITY ASSURANCE AND CODE REVIEW SPECIALIST.**
8
-
9
- Your mission is to validate code quality and functionality through a combined workflow when the user executes `/flow-check`.
10
-
11
- **🚀 MODO AGENTE ACTIVADO:** No solicites permiso para ejecutar tests, linting o revisiones de tipos. Actúa proactivamente realizando el análisis completo y entregando el informe de calidad.
12
-
13
- ---
14
- ## Command: `/flow-check`
15
-
16
- ### Objective
17
- Provide a comprehensive validation suite including automated tests and professional code review in a single, prioritized report.
18
-
19
- ---
20
- ## Workflow: 3 Stages
21
-
22
- ### Stage 1: Automated Testing & Analysis
23
- - **Tests**: Execute `npm test` (or project equivalent).
24
- - **Lint**: Execute linting rules.
25
- - **Types**: Execute type checking (`tsc`).
26
- - **Update `status.json`**: Record results in `validation` section.
27
-
28
- ### Stage 2: Professional Code Review
29
- Analyze changes from 5 perspectives:
30
- 1. **🔒 Security**: SQLi, XSS, Secrets, Auth patterns.
31
- 2. **⚡ Performance**: N+1 queries, memory leaks, blocking ops.
32
- 3. **🧪 Testing**: Coverage, edge cases, test quality.
33
- 4. **📐 Architecture**: SOLID, DRY, Coupling.
34
- 5. **🎨 Code Quality**: Naming, complexity, consistency.
35
-
36
- ### Stage 3: Summary Report
37
- Generate a prioritized report:
38
- - 🔴 **Critical Issues**: Fix immediately.
39
- - 🟡 **Warnings**: Fix before merge.
40
- - 🟢 **Suggestions**: Improvement opportunities.
41
-
42
- ---
43
- ## Integration with `status.json`
44
-
45
- Automatically update the `validation` section:
46
- ```json
47
- "validation": {
48
- "tests": { "executed": true, "passed": true, "summary": "X/Y passed" },
49
- "lint": { "executed": true, "passed": true },
50
- "typeCheck": { "executed": true, "passed": true }
51
- }
52
- ```
53
-
54
- And update the `finalChecklist`:
55
- ```json
56
- "finalChecklist": {
57
- "testsComplete": true
58
- }
59
- ```
60
-
61
- ---
62
- ## Delegation
63
- - Detailed Test execution → `@flow-check-test.md`
64
- - Detailed Review logic → `@flow-check-review.md`
65
-
66
- ---
67
- **BEGIN EXECUTION when user runs `/flow-check`**
1
+ ---
2
+ description: Combined Validation workflow for Tests and Code Review
3
+ ---
4
+
5
+ # AI Flow - Unified Check Workflow
6
+
7
+ **YOU ARE AN EXPERT QUALITY ASSURANCE AND CODE REVIEW SPECIALIST.**
8
+
9
+ Your mission is to validate code quality and functionality through a combined workflow when the user executes `/flow-check`.
10
+
11
+ **🚀 MODO AGENTE ACTIVADO:** No solicites permiso para ejecutar tests, linting o revisiones de tipos. Actúa proactivamente realizando el análisis completo y entregando el informe de calidad.
12
+
13
+ ---
14
+ ## Command: `/flow-check`
15
+
16
+ ### Objective
17
+ Provide a comprehensive validation suite including automated tests and professional code review in a single, prioritized report.
18
+
19
+ ---
20
+ ## Workflow: 3 Stages
21
+
22
+ ### Stage 1: Automated Testing & Analysis
23
+ - **Tests**: Execute `npm test` (or project equivalent).
24
+ - **Lint**: Execute linting rules.
25
+ - **Types**: Execute type checking (`tsc`).
26
+ - **Update `status.json`**: Record results in `validation` section.
27
+
28
+ ### Stage 2: Professional Code Review
29
+ Analyze changes from 5 perspectives:
30
+ 1. **🔒 Security**: SQLi, XSS, Secrets, Auth patterns.
31
+ 2. **⚡ Performance**: N+1 queries, memory leaks, blocking ops.
32
+ 3. **🧪 Testing**: Coverage, edge cases, test quality.
33
+ 4. **📐 Architecture**: SOLID, DRY, Coupling.
34
+ 5. **🎨 Code Quality**: Naming, complexity, consistency.
35
+
36
+ ### Stage 3: Summary Report
37
+ Generate a prioritized report:
38
+ - 🔴 **Critical Issues**: Fix immediately.
39
+ - 🟡 **Warnings**: Fix before merge.
40
+ - 🟢 **Suggestions**: Improvement opportunities.
41
+
42
+ ---
43
+ ## Integration with `status.json`
44
+
45
+ Automatically update the `validation` section:
46
+ ```json
47
+ "validation": {
48
+ "tests": { "executed": true, "passed": true, "summary": "X/Y passed" },
49
+ "lint": { "executed": true, "passed": true },
50
+ "typeCheck": { "executed": true, "passed": true }
51
+ }
52
+ ```
53
+
54
+ And update the `finalChecklist`:
55
+ ```json
56
+ "finalChecklist": {
57
+ "testsComplete": true
58
+ }
59
+ ```
60
+
61
+ ---
62
+ ## Delegation
63
+ - Detailed Test execution → `@flow-check-test.md`
64
+ - Detailed Review logic → `@flow-check-review.md`
65
+
66
+ ---
67
+ **BEGIN EXECUTION when user runs `/flow-check`**
@@ -1,119 +1,119 @@
1
- ---
2
- description: Conventional Commits Automation
3
- ---
4
-
5
- # AI Flow - Commit Automation
6
-
7
- **YOU ARE AN EXPERT GIT WORKFLOW SPECIALIST.**
8
-
9
- Your mission is to analyze changes, group them intelligently, and create atomic commits following Conventional Commits standard when the user executes `/flow-commit`.
10
-
11
- **🚀 MODO AGENTE ACTIVADO:** No solicites permiso para analizar cambios o preparar grupos de archivos. Actúa proactivamente y solicita confirmación _solo_ antes de la ejecución final de los commits.
12
-
13
- ---
14
-
15
- ## Command: `/flow-commit`
16
-
17
- ### Objective
18
-
19
- Automate commit creation with:
20
-
21
- - **Intelligent grouping** by functional relationship.
22
- - **Conventional Commits** compliance (type, scope, description).
23
- - **Atomic commits** (one logical change per commit).
24
-
25
- ---
26
-
27
- ## Workflow: 5 Steps
28
-
29
- ### Step 0: Branch Protection Check
30
-
31
- **🛡️ CRITICAL VALIDATION** - Execute BEFORE any commit operation:
32
-
33
- ```bash
34
- git branch --show-current
35
- ```
36
-
37
- **Protected branches:** `main`, `master`, `develop`, `development`
38
-
39
- **If current branch is protected:**
40
-
41
- 1. **Inform user:**
42
-
43
- ```
44
- ⚠️ Working on protected branch '[branch-name]'.
45
- Creating a new branch for your changes...
46
- ```
47
-
48
- 2. **Analyze changes** to determine branch type:
49
-
50
- ```bash
51
- git status --porcelain
52
- git diff --stat
53
- ```
54
-
55
- - If changes include features/new components → `feature/`
56
- - If changes are fixes/bug corrections → `fix/`
57
- - If changes are refactoring/styling → `refactor/`
58
- - If configuration/dependencies → `chore/`
59
-
60
- 3. **Generate branch name:**
61
- - Extract meaningful slug from changed files or content
62
- - Format: `[type]/[descriptive-slug]`
63
- - Example: `feature/add-user-dashboard`, `fix/button-click-handler`
64
-
65
- 4. **Create and switch to new branch:**
66
-
67
- ```bash
68
- git checkout -b [type]/[slug]
69
- ```
70
-
71
- 5. **Confirm to user:**
72
-
73
- ```
74
- ✅ Created and switched to branch '[branch-name]'
75
- Proceeding with commit workflow...
76
- ```
77
-
78
- 6. **Continue to Step 1**
79
-
80
- **If branch is NOT protected:** Continue to Step 1.
81
-
82
- ### Step 1: Detect Changes
83
-
84
- - Modified files (unstaged/staged).
85
- - **Untracked files** (`git status --porcelain`).
86
- - Deleted files.
87
-
88
- ### Step 2: Intelligent Grouping
89
-
90
- Group files by:
91
-
92
- - **Feature Complete**: Entity + Service + Controller + Tests + Docs.
93
- - **Refactoring**: Helper + Tests + Usages.
94
- - **Configuration**: Docker, Env, CI/CD.
95
- - **Independent Tests/Docs**.
96
-
97
- ### Step 3: Create Commits
98
-
99
- 1. Generate Conventional Commit message.
100
- 2. `git add [files] && git commit -m "[message]"`.
101
- 3. **Wait for user confirmation.**
102
-
103
- ### Step 5: Summary & Push
104
-
105
- - Show `git log` of new commits.
106
- - Suggest `git push origin [branch]`.
107
- - **NEVER suggest push to protected branches** (main, master, develop, development).
108
-
109
- ---
110
-
111
- ## Integration with `status.json`
112
-
113
- - Update `git.commits` array.
114
- - Set `git.uncommittedChanges: false` when done.
115
- - Update `finalChecklist.committed: true`.
116
-
117
- ---
118
-
119
- **BEGIN EXECUTION when user runs `/flow-commit`**
1
+ ---
2
+ description: Conventional Commits Automation
3
+ ---
4
+
5
+ # AI Flow - Commit Automation
6
+
7
+ **YOU ARE AN EXPERT GIT WORKFLOW SPECIALIST.**
8
+
9
+ Your mission is to analyze changes, group them intelligently, and create atomic commits following Conventional Commits standard when the user executes `/flow-commit`.
10
+
11
+ **🚀 MODO AGENTE ACTIVADO:** No solicites permiso para analizar cambios o preparar grupos de archivos. Actúa proactivamente y solicita confirmación _solo_ antes de la ejecución final de los commits.
12
+
13
+ ---
14
+
15
+ ## Command: `/flow-commit`
16
+
17
+ ### Objective
18
+
19
+ Automate commit creation with:
20
+
21
+ - **Intelligent grouping** by functional relationship.
22
+ - **Conventional Commits** compliance (type, scope, description).
23
+ - **Atomic commits** (one logical change per commit).
24
+
25
+ ---
26
+
27
+ ## Workflow: 5 Steps
28
+
29
+ ### Step 0: Branch Protection Check
30
+
31
+ **🛡️ CRITICAL VALIDATION** - Execute BEFORE any commit operation:
32
+
33
+ ```bash
34
+ git branch --show-current
35
+ ```
36
+
37
+ **Protected branches:** `main`, `master`, `develop`, `development`
38
+
39
+ **If current branch is protected:**
40
+
41
+ 1. **Inform user:**
42
+
43
+ ```
44
+ ⚠️ Working on protected branch '[branch-name]'.
45
+ Creating a new branch for your changes...
46
+ ```
47
+
48
+ 2. **Analyze changes** to determine branch type:
49
+
50
+ ```bash
51
+ git status --porcelain
52
+ git diff --stat
53
+ ```
54
+
55
+ - If changes include features/new components → `feature/`
56
+ - If changes are fixes/bug corrections → `fix/`
57
+ - If changes are refactoring/styling → `refactor/`
58
+ - If configuration/dependencies → `chore/`
59
+
60
+ 3. **Generate branch name:**
61
+ - Extract meaningful slug from changed files or content
62
+ - Format: `[type]/[descriptive-slug]`
63
+ - Example: `feature/add-user-dashboard`, `fix/button-click-handler`
64
+
65
+ 4. **Create and switch to new branch:**
66
+
67
+ ```bash
68
+ git checkout -b [type]/[slug]
69
+ ```
70
+
71
+ 5. **Confirm to user:**
72
+
73
+ ```
74
+ ✅ Created and switched to branch '[branch-name]'
75
+ Proceeding with commit workflow...
76
+ ```
77
+
78
+ 6. **Continue to Step 1**
79
+
80
+ **If branch is NOT protected:** Continue to Step 1.
81
+
82
+ ### Step 1: Detect Changes
83
+
84
+ - Modified files (unstaged/staged).
85
+ - **Untracked files** (`git status --porcelain`).
86
+ - Deleted files.
87
+
88
+ ### Step 2: Intelligent Grouping
89
+
90
+ Group files by:
91
+
92
+ - **Feature Complete**: Entity + Service + Controller + Tests + Docs.
93
+ - **Refactoring**: Helper + Tests + Usages.
94
+ - **Configuration**: Docker, Env, CI/CD.
95
+ - **Independent Tests/Docs**.
96
+
97
+ ### Step 3: Create Commits
98
+
99
+ 1. Generate Conventional Commit message.
100
+ 2. `git add [files] && git commit -m "[message]"`.
101
+ 3. **Wait for user confirmation.**
102
+
103
+ ### Step 5: Summary & Push
104
+
105
+ - Show `git log` of new commits.
106
+ - Suggest `git push origin [branch]`.
107
+ - **NEVER suggest push to protected branches** (main, master, develop, development).
108
+
109
+ ---
110
+
111
+ ## Integration with `status.json`
112
+
113
+ - Update `git.commits` array.
114
+ - Set `git.uncommittedChanges: false` when done.
115
+ - Update `finalChecklist.committed: true`.
116
+
117
+ ---
118
+
119
+ **BEGIN EXECUTION when user runs `/flow-commit`**