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.
- package/LICENSE +21 -21
- package/README.md +570 -567
- package/dist/cli.js +30 -2
- package/dist/cli.js.map +1 -1
- package/package.json +73 -73
- package/prompts/backend/flow-build-phase-0.md +535 -425
- package/prompts/backend/flow-build-phase-1.md +626 -626
- package/prompts/backend/flow-build-phase-10.md +340 -340
- package/prompts/backend/flow-build-phase-2.md +573 -573
- package/prompts/backend/flow-build-phase-3.md +834 -782
- package/prompts/backend/flow-build-phase-4.md +554 -554
- package/prompts/backend/flow-build-phase-5.md +703 -703
- package/prompts/backend/flow-build-phase-6.md +524 -524
- package/prompts/backend/flow-build-phase-7.md +1001 -1001
- package/prompts/backend/flow-build-phase-8.md +1407 -1407
- package/prompts/backend/flow-build-phase-9.md +477 -477
- package/prompts/backend/flow-build.md +137 -137
- package/prompts/backend/flow-check-review.md +20 -20
- package/prompts/backend/flow-check-test.md +14 -14
- package/prompts/backend/flow-check.md +67 -67
- package/prompts/backend/flow-commit.md +119 -119
- package/prompts/backend/flow-docs-sync.md +354 -354
- package/prompts/backend/flow-work-feature.md +61 -61
- package/prompts/backend/flow-work-fix.md +46 -46
- package/prompts/backend/flow-work-refactor.md +48 -48
- package/prompts/backend/flow-work-resume.md +34 -34
- package/prompts/backend/flow-work.md +1286 -1023
- package/prompts/desktop/flow-build-phase-0.md +359 -0
- package/prompts/desktop/flow-build-phase-1.md +295 -0
- package/prompts/desktop/flow-build-phase-10.md +357 -0
- package/prompts/desktop/flow-build-phase-2.md +282 -0
- package/prompts/desktop/flow-build-phase-3.md +291 -0
- package/prompts/desktop/flow-build-phase-4.md +308 -0
- package/prompts/desktop/flow-build-phase-5.md +269 -0
- package/prompts/desktop/flow-build-phase-6.md +350 -0
- package/prompts/desktop/flow-build-phase-7.md +297 -0
- package/prompts/desktop/flow-build-phase-8.md +541 -0
- package/prompts/desktop/flow-build-phase-9.md +439 -0
- package/prompts/desktop/flow-build.md +156 -0
- package/prompts/desktop/flow-check-review.md +20 -0
- package/prompts/desktop/flow-check-test.md +14 -0
- package/prompts/desktop/flow-check.md +67 -0
- package/prompts/desktop/flow-commit.md +119 -0
- package/prompts/desktop/flow-docs-sync.md +354 -0
- package/prompts/desktop/flow-work-feature.md +61 -0
- package/prompts/desktop/flow-work-fix.md +46 -0
- package/prompts/desktop/flow-work-refactor.md +48 -0
- package/prompts/desktop/flow-work-resume.md +34 -0
- package/prompts/desktop/flow-work.md +1390 -0
- package/prompts/frontend/flow-build-phase-0.md +425 -425
- package/prompts/frontend/flow-build-phase-1.md +626 -626
- package/prompts/frontend/flow-build-phase-10.md +33 -33
- package/prompts/frontend/flow-build-phase-2.md +573 -573
- package/prompts/frontend/flow-build-phase-3.md +782 -782
- package/prompts/frontend/flow-build-phase-4.md +554 -554
- package/prompts/frontend/flow-build-phase-5.md +703 -703
- package/prompts/frontend/flow-build-phase-6.md +524 -524
- package/prompts/frontend/flow-build-phase-7.md +1001 -1001
- package/prompts/frontend/flow-build-phase-8.md +872 -872
- package/prompts/frontend/flow-build-phase-9.md +94 -94
- package/prompts/frontend/flow-build.md +137 -137
- package/prompts/frontend/flow-check-review.md +20 -20
- package/prompts/frontend/flow-check-test.md +14 -14
- package/prompts/frontend/flow-check.md +67 -67
- package/prompts/frontend/flow-commit.md +119 -119
- package/prompts/frontend/flow-docs-sync.md +550 -550
- package/prompts/frontend/flow-work-feature.md +61 -61
- package/prompts/frontend/flow-work-fix.md +38 -38
- package/prompts/frontend/flow-work-refactor.md +48 -48
- package/prompts/frontend/flow-work-resume.md +34 -34
- package/prompts/frontend/flow-work.md +1320 -1027
- package/prompts/mobile/flow-build-phase-0.md +425 -425
- package/prompts/mobile/flow-build-phase-1.md +626 -626
- package/prompts/mobile/flow-build-phase-10.md +32 -32
- package/prompts/mobile/flow-build-phase-2.md +573 -573
- package/prompts/mobile/flow-build-phase-3.md +782 -782
- package/prompts/mobile/flow-build-phase-4.md +554 -554
- package/prompts/mobile/flow-build-phase-5.md +703 -703
- package/prompts/mobile/flow-build-phase-6.md +524 -524
- package/prompts/mobile/flow-build-phase-7.md +1001 -1001
- package/prompts/mobile/flow-build-phase-8.md +888 -888
- package/prompts/mobile/flow-build-phase-9.md +90 -90
- package/prompts/mobile/flow-build.md +135 -135
- package/prompts/mobile/flow-check-review.md +20 -20
- package/prompts/mobile/flow-check-test.md +14 -14
- package/prompts/mobile/flow-check.md +67 -67
- package/prompts/mobile/flow-commit.md +119 -119
- package/prompts/mobile/flow-docs-sync.md +620 -620
- package/prompts/mobile/flow-work-feature.md +61 -61
- package/prompts/mobile/flow-work-fix.md +46 -46
- package/prompts/mobile/flow-work-refactor.md +48 -48
- package/prompts/mobile/flow-work-resume.md +34 -34
- package/prompts/mobile/flow-work.md +1329 -1023
- package/prompts/shared/mermaid-guidelines.md +102 -102
- package/prompts/shared/scope-levels.md +114 -114
- package/prompts/shared/smart-skip-preflight.md +214 -214
- package/prompts/shared/story-points.md +55 -55
- package/prompts/shared/task-format.md +74 -74
- package/prompts/shared/task-summary-template.md +277 -277
- package/templates/AGENT.template.md +443 -443
- package/templates/backend/.clauderules.template +112 -112
- package/templates/backend/.cursorrules.template +102 -102
- package/templates/backend/README.template.md +2 -2
- package/templates/backend/ai-instructions.template.md +2 -2
- package/templates/backend/copilot-instructions.template.md +2 -2
- package/templates/backend/docs/api.template.md +320 -320
- package/templates/backend/docs/business-flows.template.md +97 -97
- package/templates/backend/docs/code-standards.template.md +2 -2
- package/templates/backend/docs/contributing.template.md +3 -3
- package/templates/backend/docs/data-model.template.md +520 -520
- package/templates/backend/docs/testing.template.md +2 -2
- package/templates/backend/project-brief.template.md +2 -2
- package/templates/backend/specs/configuration.template.md +2 -2
- package/templates/backend/specs/security.template.md +2 -2
- package/templates/desktop/.clauderules.template +112 -0
- package/templates/desktop/.cursorrules.template +102 -0
- package/templates/desktop/README.template.md +170 -0
- package/templates/desktop/ai-instructions.template.md +366 -0
- package/templates/desktop/copilot-instructions.template.md +140 -0
- package/templates/desktop/docs/docs/api.template.md +320 -0
- package/templates/desktop/docs/docs/architecture.template.md +724 -0
- package/templates/desktop/docs/docs/business-flows.template.md +102 -0
- package/templates/desktop/docs/docs/code-standards.template.md +792 -0
- package/templates/desktop/docs/docs/contributing.template.md +149 -0
- package/templates/desktop/docs/docs/data-model.template.md +520 -0
- package/templates/desktop/docs/docs/operations.template.md +720 -0
- package/templates/desktop/docs/docs/testing.template.md +722 -0
- package/templates/desktop/project-brief.template.md +150 -0
- package/templates/desktop/specs/specs/configuration.template.md +121 -0
- package/templates/desktop/specs/specs/security.template.md +392 -0
- package/templates/frontend/README.template.md +2 -2
- package/templates/frontend/ai-instructions.template.md +2 -2
- package/templates/frontend/docs/api-integration.template.md +362 -362
- package/templates/frontend/docs/components.template.md +2 -2
- package/templates/frontend/docs/error-handling.template.md +360 -360
- package/templates/frontend/docs/operations.template.md +107 -107
- package/templates/frontend/docs/performance.template.md +124 -124
- package/templates/frontend/docs/pwa.template.md +119 -119
- package/templates/frontend/docs/state-management.template.md +2 -2
- package/templates/frontend/docs/styling.template.md +2 -2
- package/templates/frontend/docs/testing.template.md +2 -2
- package/templates/frontend/project-brief.template.md +2 -2
- package/templates/frontend/specs/accessibility.template.md +95 -95
- package/templates/frontend/specs/configuration.template.md +2 -2
- package/templates/frontend/specs/security.template.md +175 -175
- package/templates/fullstack/README.template.md +252 -252
- package/templates/fullstack/ai-instructions.template.md +444 -444
- package/templates/fullstack/project-brief.template.md +157 -157
- package/templates/fullstack/specs/configuration.template.md +340 -340
- package/templates/mobile/README.template.md +167 -167
- package/templates/mobile/ai-instructions.template.md +196 -196
- package/templates/mobile/docs/app-store.template.md +135 -135
- package/templates/mobile/docs/architecture.template.md +63 -63
- package/templates/mobile/docs/native-features.template.md +94 -94
- package/templates/mobile/docs/navigation.template.md +59 -59
- package/templates/mobile/docs/offline-strategy.template.md +65 -65
- package/templates/mobile/docs/permissions.template.md +56 -56
- package/templates/mobile/docs/state-management.template.md +85 -85
- package/templates/mobile/docs/testing.template.md +109 -109
- package/templates/mobile/project-brief.template.md +69 -69
- package/templates/mobile/specs/build-configuration.template.md +91 -91
- package/templates/mobile/specs/deployment.template.md +92 -92
- 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`**
|