@atlashub/smartstack-cli 1.5.1 → 1.5.2

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 (147) hide show
  1. package/.documentation/css/styles.css +2168 -2168
  2. package/.documentation/js/app.js +794 -794
  3. package/config/default-config.json +86 -86
  4. package/config/settings.json +53 -53
  5. package/config/settings.local.example.json +16 -16
  6. package/dist/index.js +0 -0
  7. package/dist/index.js.map +1 -1
  8. package/package.json +88 -88
  9. package/templates/agents/action.md +36 -36
  10. package/templates/agents/efcore/conflicts.md +84 -84
  11. package/templates/agents/efcore/db-deploy.md +51 -51
  12. package/templates/agents/efcore/db-reset.md +59 -59
  13. package/templates/agents/efcore/db-seed.md +56 -56
  14. package/templates/agents/efcore/db-status.md +64 -64
  15. package/templates/agents/efcore/migration.md +85 -85
  16. package/templates/agents/efcore/rebase-snapshot.md +62 -62
  17. package/templates/agents/efcore/scan.md +90 -90
  18. package/templates/agents/efcore/squash.md +67 -67
  19. package/templates/agents/explore-codebase.md +65 -65
  20. package/templates/agents/explore-docs.md +97 -97
  21. package/templates/agents/fix-grammar.md +49 -49
  22. package/templates/agents/gitflow/abort.md +45 -45
  23. package/templates/agents/gitflow/cleanup.md +85 -85
  24. package/templates/agents/gitflow/commit.md +40 -40
  25. package/templates/agents/gitflow/exec.md +48 -48
  26. package/templates/agents/gitflow/finish.md +92 -92
  27. package/templates/agents/gitflow/init.md +139 -139
  28. package/templates/agents/gitflow/merge.md +62 -62
  29. package/templates/agents/gitflow/plan.md +42 -42
  30. package/templates/agents/gitflow/pr.md +78 -78
  31. package/templates/agents/gitflow/review.md +49 -49
  32. package/templates/agents/gitflow/start.md +61 -61
  33. package/templates/agents/gitflow/status.md +32 -32
  34. package/templates/agents/snipper.md +36 -36
  35. package/templates/agents/websearch.md +46 -46
  36. package/templates/commands/_resources/formatting-guide.md +124 -124
  37. package/templates/commands/ai-prompt.md +315 -315
  38. package/templates/commands/apex/1-analyze.md +100 -100
  39. package/templates/commands/apex/2-plan.md +145 -145
  40. package/templates/commands/apex/3-execute.md +171 -171
  41. package/templates/commands/apex/4-examine.md +116 -116
  42. package/templates/commands/apex/5-tasks.md +209 -209
  43. package/templates/commands/apex.md +76 -76
  44. package/templates/commands/application/create.md +362 -362
  45. package/templates/commands/application/templates-backend.md +463 -463
  46. package/templates/commands/application/templates-frontend.md +517 -517
  47. package/templates/commands/application/templates-i18n.md +478 -478
  48. package/templates/commands/application/templates-seed.md +362 -362
  49. package/templates/commands/application.md +303 -303
  50. package/templates/commands/business-analyse/0-orchestrate.md +640 -640
  51. package/templates/commands/business-analyse/1-init.md +269 -269
  52. package/templates/commands/business-analyse/2-discover.md +520 -520
  53. package/templates/commands/business-analyse/3-analyse.md +408 -408
  54. package/templates/commands/business-analyse/4-specify.md +598 -598
  55. package/templates/commands/business-analyse/5-validate.md +326 -326
  56. package/templates/commands/business-analyse/6-handoff.md +746 -746
  57. package/templates/commands/business-analyse/7-doc-html.md +602 -602
  58. package/templates/commands/business-analyse/bug.md +325 -325
  59. package/templates/commands/business-analyse/change-request.md +368 -368
  60. package/templates/commands/business-analyse/hotfix.md +200 -200
  61. package/templates/commands/business-analyse.md +640 -640
  62. package/templates/commands/controller/create.md +216 -216
  63. package/templates/commands/controller/postman-templates.md +528 -528
  64. package/templates/commands/controller/templates.md +600 -600
  65. package/templates/commands/controller.md +337 -337
  66. package/templates/commands/create/agent.md +138 -138
  67. package/templates/commands/create/command.md +166 -166
  68. package/templates/commands/create/hook.md +234 -234
  69. package/templates/commands/create/plugin.md +329 -329
  70. package/templates/commands/create/project.md +507 -507
  71. package/templates/commands/create/skill.md +199 -199
  72. package/templates/commands/create.md +220 -220
  73. package/templates/commands/debug.md +95 -95
  74. package/templates/commands/documentation/module.md +202 -202
  75. package/templates/commands/documentation/templates.md +432 -432
  76. package/templates/commands/documentation.md +190 -190
  77. package/templates/commands/efcore/_env-check.md +153 -153
  78. package/templates/commands/efcore/conflicts.md +186 -186
  79. package/templates/commands/efcore/db-deploy.md +193 -193
  80. package/templates/commands/efcore/db-reset.md +426 -426
  81. package/templates/commands/efcore/db-seed.md +326 -326
  82. package/templates/commands/efcore/db-status.md +226 -226
  83. package/templates/commands/efcore/migration.md +400 -400
  84. package/templates/commands/efcore/rebase-snapshot.md +264 -264
  85. package/templates/commands/efcore/scan.md +198 -198
  86. package/templates/commands/efcore/squash.md +298 -298
  87. package/templates/commands/efcore.md +224 -224
  88. package/templates/commands/epct.md +69 -69
  89. package/templates/commands/explain.md +186 -186
  90. package/templates/commands/explore.md +45 -45
  91. package/templates/commands/feature-full.md +267 -267
  92. package/templates/commands/gitflow/1-init.md +1038 -1038
  93. package/templates/commands/gitflow/10-start.md +768 -768
  94. package/templates/commands/gitflow/11-finish.md +457 -457
  95. package/templates/commands/gitflow/12-cleanup.md +276 -276
  96. package/templates/commands/gitflow/13-sync.md +216 -216
  97. package/templates/commands/gitflow/14-rebase.md +251 -251
  98. package/templates/commands/gitflow/2-status.md +277 -277
  99. package/templates/commands/gitflow/3-commit.md +344 -344
  100. package/templates/commands/gitflow/4-plan.md +145 -145
  101. package/templates/commands/gitflow/5-exec.md +147 -147
  102. package/templates/commands/gitflow/6-abort.md +344 -344
  103. package/templates/commands/gitflow/7-pull-request.md +453 -355
  104. package/templates/commands/gitflow/8-review.md +240 -176
  105. package/templates/commands/gitflow/9-merge.md +451 -365
  106. package/templates/commands/gitflow.md +128 -128
  107. package/templates/commands/implement.md +663 -663
  108. package/templates/commands/init.md +567 -567
  109. package/templates/commands/mcp-integration.md +330 -330
  110. package/templates/commands/notification.md +129 -129
  111. package/templates/commands/oneshot.md +57 -57
  112. package/templates/commands/quick-search.md +72 -72
  113. package/templates/commands/ralph-loop/cancel-ralph.md +18 -18
  114. package/templates/commands/ralph-loop/help.md +126 -126
  115. package/templates/commands/ralph-loop/ralph-loop.md +18 -18
  116. package/templates/commands/review.md +106 -106
  117. package/templates/commands/utils/test-web-config.md +160 -160
  118. package/templates/commands/utils/test-web.md +151 -151
  119. package/templates/commands/validate.md +233 -233
  120. package/templates/commands/workflow.md +193 -193
  121. package/templates/gitflow/config.json +138 -138
  122. package/templates/hooks/ef-migration-check.md +139 -139
  123. package/templates/hooks/hooks.json +25 -25
  124. package/templates/hooks/stop-hook.sh +177 -177
  125. package/templates/skills/ai-prompt/SKILL.md +778 -778
  126. package/templates/skills/application/SKILL.md +563 -563
  127. package/templates/skills/application/templates-backend.md +450 -450
  128. package/templates/skills/application/templates-frontend.md +531 -531
  129. package/templates/skills/application/templates-i18n.md +520 -520
  130. package/templates/skills/application/templates-seed.md +647 -647
  131. package/templates/skills/business-analyse/SKILL.md +191 -191
  132. package/templates/skills/business-analyse/questionnaire.md +283 -283
  133. package/templates/skills/business-analyse/templates-frd.md +477 -477
  134. package/templates/skills/business-analyse/templates-react.md +580 -580
  135. package/templates/skills/controller/SKILL.md +240 -240
  136. package/templates/skills/controller/postman-templates.md +614 -614
  137. package/templates/skills/controller/templates.md +1468 -1468
  138. package/templates/skills/documentation/SKILL.md +133 -133
  139. package/templates/skills/documentation/templates.md +476 -476
  140. package/templates/skills/feature-full/SKILL.md +838 -838
  141. package/templates/skills/notification/SKILL.md +555 -555
  142. package/templates/skills/ui-components/SKILL.md +870 -870
  143. package/templates/skills/workflow/SKILL.md +582 -582
  144. package/templates/test-web/api-health.json +38 -38
  145. package/templates/test-web/minimal.json +19 -19
  146. package/templates/test-web/npm-package.json +46 -46
  147. package/templates/test-web/seo-check.json +54 -54
@@ -1,145 +1,145 @@
1
- ---
2
- description: Phase 4 - Generate integration plan with versioning and EF Core analysis
3
- agent: gitflow-plan
4
- model: sonnet
5
- ---
6
-
7
- # Phase 4: PLAN - Integration Planning
8
-
9
- Tu es expert GitFlow et EF Core. Cree un plan d'integration pour la branche courante.
10
-
11
- ---
12
-
13
- ## Pre-validation (OBLIGATOIRE)
14
-
15
- **Verifier la branche courante AVANT toute action:**
16
-
17
- ```bash
18
- BRANCH=$(git rev-parse --abbrev-ref HEAD)
19
-
20
- # Branches autorisees: feature/*, release/*, hotfix/*
21
- if [[ ! $BRANCH =~ ^(feature|release|hotfix)/ ]]; then
22
- echo "ERREUR: Cette commande ne peut etre executee que depuis une branche GitFlow"
23
- echo ""
24
- echo "Branche actuelle: $BRANCH"
25
- echo "Branches autorisees: feature/*, release/*, hotfix/*"
26
- echo ""
27
- echo "Pour creer une branche:"
28
- echo " /gitflow:10-start feature \"description\""
29
- echo " /gitflow:10-start release \"v1.x.0\""
30
- echo " /gitflow:10-start hotfix \"correctif\""
31
- exit 1
32
- fi
33
- ```
34
-
35
- **Si branche invalide:** Afficher l'erreur et STOPPER. Ne pas continuer le workflow.
36
-
37
- ---
38
-
39
- ## Workflow
40
-
41
- ### 1. Analyser contexte
42
-
43
- **Git:**
44
- - Branche courante et type (feature/release/hotfix)
45
- - Commits depuis divergence avec develop/main
46
- - Fichiers modifies
47
-
48
- **Version:**
49
- - Lire depuis source configuree (csproj, VERSION, etc.)
50
- - Calculer nouvelle version selon type branche
51
-
52
- **EF Core:**
53
- - Migrations sur cette branche
54
- - Migrations sur develop (absentes ici)
55
- - Conflit ModelSnapshot? (modifie des deux cotes)
56
-
57
- ### 2. Determiner strategie
58
-
59
- **Feature → Develop:**
60
- | Condition | Strategie |
61
- |-----------|-----------|
62
- | Pas de migrations | Rebase + Merge --no-ff |
63
- | Migrations sans conflit | Rebase + Merge --no-ff |
64
- | Conflit ModelSnapshot | Rebase + Remove migration + Re-add |
65
-
66
- **Release → Main + Develop:**
67
- | Condition | Strategie |
68
- |-----------|-----------|
69
- | Release stable | Tag v{VERSION} + Double merge |
70
- | Migrations pending | Script SQL idempotent |
71
- | Version | Auto-increment minor |
72
-
73
- **Hotfix → Main + Develop:**
74
- | Condition | Strategie |
75
- |-----------|-----------|
76
- | Migration urgente | Prefix `Hotfix_` + Script SQL |
77
- | Version | Auto-increment patch |
78
-
79
- ### 3. Generate plan file
80
-
81
- Create plan in [.claude/gitflow/plans/](.claude/gitflow/plans/) named `{type}-{nom}_{date}.md`:
82
-
83
- ````markdown
84
- # Plan: {BRANCH_NAME}
85
-
86
- ## Meta
87
- - **Source**: {branch} → **Cible**: {target}
88
- - **Version**: {current} → {new}
89
-
90
- ## Analyse
91
- | Git | EF Core |
92
- |-----|---------|
93
- | {n} commits | {n} migrations |
94
- | {n} fichiers | Conflit: {oui|non} |
95
-
96
- ## Pre-requis
97
- - [ ] Working dir propre
98
- - [ ] Build OK
99
- - [ ] Tests OK
100
-
101
- ## Etapes
102
- 1. Preparation (fetch, backup)
103
- 2. Migrations (si conflit: remove + rebase + re-add)
104
- 3. Integration (rebase/merge selon strategie)
105
- 4. Version (tag + update fichier source)
106
- 5. Validation (build, tests, migrations list)
107
-
108
- ## Rollback
109
- Reset au commit initial + restore migrations backup
110
-
111
- ## Executer
112
-
113
- ```
114
- /gitflow:5-exec {fichier_plan}
115
- ```
116
- ````
117
-
118
- ### 4. Afficher resume
119
-
120
- ````
121
- Plan genere: .claude/gitflow/plans/{name}.md
122
-
123
- Branche: {source} → {target}
124
- Version: {current} → {new}
125
- Strategie: {rebase|merge|remove+readd}
126
-
127
- Executez:
128
-
129
- ```
130
- /gitflow:5-exec
131
- ```
132
- ````
133
-
134
- ---
135
-
136
- ## Cas speciaux
137
-
138
- **Migrations sur les deux branches:**
139
- - Merger develop d'abord
140
- - Resoudre conflits ModelSnapshot
141
- - `dotnet ef migrations add MergeSnapshot --force`
142
-
143
- **Hotfix avec migration:**
144
- - Prefix migration `Hotfix_`
145
- - Script SQL FROM derniere migration main
1
+ ---
2
+ description: Phase 4 - Generate integration plan with versioning and EF Core analysis
3
+ agent: gitflow-plan
4
+ model: sonnet
5
+ ---
6
+
7
+ # Phase 4: PLAN - Integration Planning
8
+
9
+ Tu es expert GitFlow et EF Core. Cree un plan d'integration pour la branche courante.
10
+
11
+ ---
12
+
13
+ ## Pre-validation (OBLIGATOIRE)
14
+
15
+ **Verifier la branche courante AVANT toute action:**
16
+
17
+ ```bash
18
+ BRANCH=$(git rev-parse --abbrev-ref HEAD)
19
+
20
+ # Branches autorisees: feature/*, release/*, hotfix/*
21
+ if [[ ! $BRANCH =~ ^(feature|release|hotfix)/ ]]; then
22
+ echo "ERREUR: Cette commande ne peut etre executee que depuis une branche GitFlow"
23
+ echo ""
24
+ echo "Branche actuelle: $BRANCH"
25
+ echo "Branches autorisees: feature/*, release/*, hotfix/*"
26
+ echo ""
27
+ echo "Pour creer une branche:"
28
+ echo " /gitflow:10-start feature \"description\""
29
+ echo " /gitflow:10-start release \"v1.x.0\""
30
+ echo " /gitflow:10-start hotfix \"correctif\""
31
+ exit 1
32
+ fi
33
+ ```
34
+
35
+ **Si branche invalide:** Afficher l'erreur et STOPPER. Ne pas continuer le workflow.
36
+
37
+ ---
38
+
39
+ ## Workflow
40
+
41
+ ### 1. Analyser contexte
42
+
43
+ **Git:**
44
+ - Branche courante et type (feature/release/hotfix)
45
+ - Commits depuis divergence avec develop/main
46
+ - Fichiers modifies
47
+
48
+ **Version:**
49
+ - Lire depuis source configuree (csproj, VERSION, etc.)
50
+ - Calculer nouvelle version selon type branche
51
+
52
+ **EF Core:**
53
+ - Migrations sur cette branche
54
+ - Migrations sur develop (absentes ici)
55
+ - Conflit ModelSnapshot? (modifie des deux cotes)
56
+
57
+ ### 2. Determiner strategie
58
+
59
+ **Feature → Develop:**
60
+ | Condition | Strategie |
61
+ |-----------|-----------|
62
+ | Pas de migrations | Rebase + Merge --no-ff |
63
+ | Migrations sans conflit | Rebase + Merge --no-ff |
64
+ | Conflit ModelSnapshot | Rebase + Remove migration + Re-add |
65
+
66
+ **Release → Main + Develop:**
67
+ | Condition | Strategie |
68
+ |-----------|-----------|
69
+ | Release stable | Tag v{VERSION} + Double merge |
70
+ | Migrations pending | Script SQL idempotent |
71
+ | Version | Auto-increment minor |
72
+
73
+ **Hotfix → Main + Develop:**
74
+ | Condition | Strategie |
75
+ |-----------|-----------|
76
+ | Migration urgente | Prefix `Hotfix_` + Script SQL |
77
+ | Version | Auto-increment patch |
78
+
79
+ ### 3. Generate plan file
80
+
81
+ Create plan in [.claude/gitflow/plans/](.claude/gitflow/plans/) named `{type}-{nom}_{date}.md`:
82
+
83
+ ````markdown
84
+ # Plan: {BRANCH_NAME}
85
+
86
+ ## Meta
87
+ - **Source**: {branch} → **Cible**: {target}
88
+ - **Version**: {current} → {new}
89
+
90
+ ## Analyse
91
+ | Git | EF Core |
92
+ |-----|---------|
93
+ | {n} commits | {n} migrations |
94
+ | {n} fichiers | Conflit: {oui|non} |
95
+
96
+ ## Pre-requis
97
+ - [ ] Working dir propre
98
+ - [ ] Build OK
99
+ - [ ] Tests OK
100
+
101
+ ## Etapes
102
+ 1. Preparation (fetch, backup)
103
+ 2. Migrations (si conflit: remove + rebase + re-add)
104
+ 3. Integration (rebase/merge selon strategie)
105
+ 4. Version (tag + update fichier source)
106
+ 5. Validation (build, tests, migrations list)
107
+
108
+ ## Rollback
109
+ Reset au commit initial + restore migrations backup
110
+
111
+ ## Executer
112
+
113
+ ```
114
+ /gitflow:5-exec {fichier_plan}
115
+ ```
116
+ ````
117
+
118
+ ### 4. Afficher resume
119
+
120
+ ````
121
+ Plan genere: .claude/gitflow/plans/{name}.md
122
+
123
+ Branche: {source} → {target}
124
+ Version: {current} → {new}
125
+ Strategie: {rebase|merge|remove+readd}
126
+
127
+ Executez:
128
+
129
+ ```
130
+ /gitflow:5-exec
131
+ ```
132
+ ````
133
+
134
+ ---
135
+
136
+ ## Cas speciaux
137
+
138
+ **Migrations sur les deux branches:**
139
+ - Merger develop d'abord
140
+ - Resoudre conflits ModelSnapshot
141
+ - `dotnet ef migrations add MergeSnapshot --force`
142
+
143
+ **Hotfix avec migration:**
144
+ - Prefix migration `Hotfix_`
145
+ - Script SQL FROM derniere migration main
@@ -1,147 +1,147 @@
1
- ---
2
- description: Phase 5 - Execute plan with versioning auto-increment
3
- agent: gitflow-exec
4
- model: sonnet
5
- args: [plan_file]
6
- ---
7
-
8
- # Phase 5: EXEC - Plan Execution
9
-
10
- Tu es expert GitFlow et EF Core. Execute le plan d'integration de maniere securisee.
11
-
12
- **Argument:** `$ARGUMENTS` = chemin plan (optionnel, prend le plus recent)
13
-
14
- ---
15
-
16
- ## Pre-validation (OBLIGATOIRE)
17
-
18
- **Verifier la branche courante AVANT toute action:**
19
-
20
- ```bash
21
- BRANCH=$(git rev-parse --abbrev-ref HEAD)
22
-
23
- # Branches autorisees: feature/*, release/*, hotfix/*
24
- if [[ ! $BRANCH =~ ^(feature|release|hotfix)/ ]]; then
25
- echo "ERREUR: Cette commande ne peut etre executee que depuis une branche GitFlow"
26
- echo ""
27
- echo "Branche actuelle: $BRANCH"
28
- echo "Branches autorisees: feature/*, release/*, hotfix/*"
29
- echo ""
30
- echo "Vous devez etre sur la branche source du plan pour l'executer."
31
- echo "Utilisez: git checkout {branche-source}"
32
- exit 1
33
- fi
34
- ```
35
-
36
- **Si branche invalide:** Afficher l'erreur et STOPPER. Ne pas continuer le workflow.
37
-
38
- ---
39
-
40
- ## Workflow
41
-
42
- ### 1. Load plan
43
-
44
- - Find plan file (argument or most recent in [.claude/gitflow/plans/](.claude/gitflow/plans/))
45
- - Extract: source branch, target, initial commit, version
46
-
47
- ### 2. Verifier pre-requis
48
-
49
- - Working directory propre
50
- - Sur la bonne branche
51
- - Build OK
52
- - Plan valide
53
-
54
- ### 3. Create checkpoint (on source branch)
55
-
56
- Save checkpoint in [.claude/gitflow/logs/](.claude/gitflow/logs/)`checkpoint_{timestamp}.json`:
57
- - Branch, commit, plan, status
58
- - Backup migrations if present
59
- - **IMPORTANT: Commit checkpoint on source branch BEFORE merge**
60
-
61
- ```bash
62
- git add .claude/gitflow/logs/checkpoint_{timestamp}.json
63
- git commit -m "chore(gitflow): create integration checkpoint"
64
- ```
65
-
66
- ### 4. Executer etapes
67
-
68
- **Rebase (si necessaire):**
69
- - Fetch origin
70
- - Rebase sur target
71
- - Si conflit ModelSnapshot: accept theirs + regenerer migration
72
-
73
- **Merge:**
74
- - Checkout target (utiliser worktree si necessaire: `git -C {worktree_path}`)
75
- - Pull
76
- - Merge --no-ff source
77
-
78
- **Release/Hotfix - Version:**
79
- 1. Lire version depuis source configuree (csproj, VERSION, etc.)
80
- 2. Creer tag avec version actuelle
81
- 3. Calculer nouvelle version (minor pour release, patch pour hotfix)
82
- 4. Mettre a jour le fichier source
83
- 5. Sync config.json
84
-
85
- **Release - Double merge:**
86
- - Merge sur main
87
- - Tag
88
- - Merge main sur develop
89
-
90
- ### 5. Archiver plan (sur target branch)
91
-
92
- **IMPORTANT: Toujours archiver et commiter sur la branche cible AVANT le push**
93
-
94
- ```bash
95
- # Sur target branch (develop)
96
- mv .claude/gitflow/plans/{plan}.md .claude/gitflow/plans/{plan}_DONE_{timestamp}.md
97
- # Mettre a jour checkpoint avec status "completed"
98
- git add .claude/gitflow/logs/ .claude/gitflow/plans/
99
- git commit -m "chore(gitflow): archive integration plan and checkpoint"
100
- ```
101
-
102
- ### 6. Push
103
-
104
- - Push target branch
105
- - Push tag(s)
106
- - Verifier CI/CD declenche
107
-
108
- ### 7. Validation
109
-
110
- - Build OK
111
- - Tests OK (si disponibles)
112
- - Migrations list correcte
113
- - Historique git correct
114
-
115
- ### 8. Finaliser
116
-
117
- - Afficher resume et prochaines etapes
118
- - Suggerer nettoyage branche source si applicable
119
-
120
- ---
121
-
122
- ## Gestion conflits ModelSnapshot
123
-
124
- Si conflit pendant rebase:
125
- 1. Accepter version develop: `git checkout --theirs */Migrations/*ModelSnapshot.cs`
126
- 2. Regenerer migration: `dotnet ef migrations add {NomMigration}`
127
- 3. Continuer rebase: `git rebase --continue`
128
-
129
- ---
130
-
131
- ## Modes
132
-
133
- | Commande | Action |
134
- |----------|--------|
135
- | `/gitflow:5-exec` | Plan le plus recent |
136
- | `/gitflow:5-exec {plan}` | Plan specifie |
137
- | `/gitflow:5-exec --yes` | Sans confirmations |
138
- | `/gitflow:5-exec --dry-run` | Simulation |
139
- | `/gitflow:5-exec --resume` | Reprendre execution interrompue |
140
-
141
- ## Rollback rapide
142
-
143
- Si echec:
144
-
145
- ```
146
- /gitflow:6-abort --checkpoint
147
- ```
1
+ ---
2
+ description: Phase 5 - Execute plan with versioning auto-increment
3
+ agent: gitflow-exec
4
+ model: sonnet
5
+ args: [plan_file]
6
+ ---
7
+
8
+ # Phase 5: EXEC - Plan Execution
9
+
10
+ Tu es expert GitFlow et EF Core. Execute le plan d'integration de maniere securisee.
11
+
12
+ **Argument:** `$ARGUMENTS` = chemin plan (optionnel, prend le plus recent)
13
+
14
+ ---
15
+
16
+ ## Pre-validation (OBLIGATOIRE)
17
+
18
+ **Verifier la branche courante AVANT toute action:**
19
+
20
+ ```bash
21
+ BRANCH=$(git rev-parse --abbrev-ref HEAD)
22
+
23
+ # Branches autorisees: feature/*, release/*, hotfix/*
24
+ if [[ ! $BRANCH =~ ^(feature|release|hotfix)/ ]]; then
25
+ echo "ERREUR: Cette commande ne peut etre executee que depuis une branche GitFlow"
26
+ echo ""
27
+ echo "Branche actuelle: $BRANCH"
28
+ echo "Branches autorisees: feature/*, release/*, hotfix/*"
29
+ echo ""
30
+ echo "Vous devez etre sur la branche source du plan pour l'executer."
31
+ echo "Utilisez: git checkout {branche-source}"
32
+ exit 1
33
+ fi
34
+ ```
35
+
36
+ **Si branche invalide:** Afficher l'erreur et STOPPER. Ne pas continuer le workflow.
37
+
38
+ ---
39
+
40
+ ## Workflow
41
+
42
+ ### 1. Load plan
43
+
44
+ - Find plan file (argument or most recent in [.claude/gitflow/plans/](.claude/gitflow/plans/))
45
+ - Extract: source branch, target, initial commit, version
46
+
47
+ ### 2. Verifier pre-requis
48
+
49
+ - Working directory propre
50
+ - Sur la bonne branche
51
+ - Build OK
52
+ - Plan valide
53
+
54
+ ### 3. Create checkpoint (on source branch)
55
+
56
+ Save checkpoint in [.claude/gitflow/logs/](.claude/gitflow/logs/)`checkpoint_{timestamp}.json`:
57
+ - Branch, commit, plan, status
58
+ - Backup migrations if present
59
+ - **IMPORTANT: Commit checkpoint on source branch BEFORE merge**
60
+
61
+ ```bash
62
+ git add .claude/gitflow/logs/checkpoint_{timestamp}.json
63
+ git commit -m "chore(gitflow): create integration checkpoint"
64
+ ```
65
+
66
+ ### 4. Executer etapes
67
+
68
+ **Rebase (si necessaire):**
69
+ - Fetch origin
70
+ - Rebase sur target
71
+ - Si conflit ModelSnapshot: accept theirs + regenerer migration
72
+
73
+ **Merge:**
74
+ - Checkout target (utiliser worktree si necessaire: `git -C {worktree_path}`)
75
+ - Pull
76
+ - Merge --no-ff source
77
+
78
+ **Release/Hotfix - Version:**
79
+ 1. Lire version depuis source configuree (csproj, VERSION, etc.)
80
+ 2. Creer tag avec version actuelle
81
+ 3. Calculer nouvelle version (minor pour release, patch pour hotfix)
82
+ 4. Mettre a jour le fichier source
83
+ 5. Sync config.json
84
+
85
+ **Release - Double merge:**
86
+ - Merge sur main
87
+ - Tag
88
+ - Merge main sur develop
89
+
90
+ ### 5. Archiver plan (sur target branch)
91
+
92
+ **IMPORTANT: Toujours archiver et commiter sur la branche cible AVANT le push**
93
+
94
+ ```bash
95
+ # Sur target branch (develop)
96
+ mv .claude/gitflow/plans/{plan}.md .claude/gitflow/plans/{plan}_DONE_{timestamp}.md
97
+ # Mettre a jour checkpoint avec status "completed"
98
+ git add .claude/gitflow/logs/ .claude/gitflow/plans/
99
+ git commit -m "chore(gitflow): archive integration plan and checkpoint"
100
+ ```
101
+
102
+ ### 6. Push
103
+
104
+ - Push target branch
105
+ - Push tag(s)
106
+ - Verifier CI/CD declenche
107
+
108
+ ### 7. Validation
109
+
110
+ - Build OK
111
+ - Tests OK (si disponibles)
112
+ - Migrations list correcte
113
+ - Historique git correct
114
+
115
+ ### 8. Finaliser
116
+
117
+ - Afficher resume et prochaines etapes
118
+ - Suggerer nettoyage branche source si applicable
119
+
120
+ ---
121
+
122
+ ## Gestion conflits ModelSnapshot
123
+
124
+ Si conflit pendant rebase:
125
+ 1. Accepter version develop: `git checkout --theirs */Migrations/*ModelSnapshot.cs`
126
+ 2. Regenerer migration: `dotnet ef migrations add {NomMigration}`
127
+ 3. Continuer rebase: `git rebase --continue`
128
+
129
+ ---
130
+
131
+ ## Modes
132
+
133
+ | Commande | Action |
134
+ |----------|--------|
135
+ | `/gitflow:5-exec` | Plan le plus recent |
136
+ | `/gitflow:5-exec {plan}` | Plan specifie |
137
+ | `/gitflow:5-exec --yes` | Sans confirmations |
138
+ | `/gitflow:5-exec --dry-run` | Simulation |
139
+ | `/gitflow:5-exec --resume` | Reprendre execution interrompue |
140
+
141
+ ## Rollback rapide
142
+
143
+ Si echec:
144
+
145
+ ```
146
+ /gitflow:6-abort --checkpoint
147
+ ```