@atlashub/smartstack-cli 3.39.0 → 3.41.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 (472) hide show
  1. package/.documentation/apex.html +644 -644
  2. package/.documentation/css/styles.css +2320 -2320
  3. package/.documentation/init.html +1377 -1377
  4. package/.documentation/js/app.js +780 -780
  5. package/.documentation/prd-json-v2.0.0.md +396 -396
  6. package/.documentation/testing-ba-e2e.md +462 -462
  7. package/config/default-config.json +95 -95
  8. package/config/mcp-defaults.json +62 -62
  9. package/config/settings.json +53 -53
  10. package/config/settings.local.example.json +16 -16
  11. package/dist/index.js +6 -3
  12. package/dist/index.js.map +1 -1
  13. package/dist/mcp-entry.mjs +6 -4
  14. package/dist/mcp-entry.mjs.map +1 -1
  15. package/package.json +115 -115
  16. package/scripts/extract-api-endpoints.ts +325 -325
  17. package/scripts/extract-business-rules.ts +440 -440
  18. package/scripts/generate-doc-with-mock-ui.ts +804 -804
  19. package/scripts/health-check.sh +168 -168
  20. package/scripts/postinstall.js +18 -18
  21. package/templates/agents/action.md +37 -37
  22. package/templates/agents/ba-reader.md +378 -378
  23. package/templates/agents/ba-writer.md +861 -861
  24. package/templates/agents/code-reviewer.md +163 -163
  25. package/templates/agents/db-reader.md +149 -149
  26. package/templates/agents/docs-context-reader.md +143 -143
  27. package/templates/agents/docs-sync-checker.md +122 -122
  28. package/templates/agents/efcore/conflicts.md +95 -84
  29. package/templates/agents/efcore/db-deploy.md +85 -74
  30. package/templates/agents/efcore/db-reset.md +96 -85
  31. package/templates/agents/efcore/db-seed.md +72 -61
  32. package/templates/agents/efcore/db-status.md +97 -86
  33. package/templates/agents/efcore/migration.md +197 -186
  34. package/templates/agents/efcore/rebase-snapshot.md +119 -108
  35. package/templates/agents/efcore/scan.md +103 -92
  36. package/templates/agents/efcore/squash.md +172 -161
  37. package/templates/agents/explore-codebase.md +66 -66
  38. package/templates/agents/explore-docs.md +98 -98
  39. package/templates/agents/fix-grammar.md +50 -50
  40. package/templates/agents/gitflow/abort.md +45 -45
  41. package/templates/agents/gitflow/cleanup.md +96 -96
  42. package/templates/agents/gitflow/commit.md +236 -236
  43. package/templates/agents/gitflow/exec.md +48 -48
  44. package/templates/agents/gitflow/finish.md +146 -146
  45. package/templates/agents/gitflow/init-clone.md +199 -199
  46. package/templates/agents/gitflow/init-detect.md +137 -137
  47. package/templates/agents/gitflow/init-validate.md +225 -225
  48. package/templates/agents/gitflow/init.md +340 -340
  49. package/templates/agents/gitflow/merge.md +145 -145
  50. package/templates/agents/gitflow/plan.md +42 -42
  51. package/templates/agents/gitflow/pr.md +191 -191
  52. package/templates/agents/gitflow/review.md +49 -49
  53. package/templates/agents/gitflow/start.md +147 -147
  54. package/templates/agents/gitflow/status.md +95 -95
  55. package/templates/agents/mcp-healthcheck.md +163 -163
  56. package/templates/agents/snipper.md +37 -37
  57. package/templates/agents/websearch.md +46 -46
  58. package/templates/hooks/appsettings-guard.sh +76 -76
  59. package/templates/hooks/docs-drift-check.md +96 -96
  60. package/templates/hooks/ef-migration-check.md +139 -139
  61. package/templates/hooks/hooks.json +58 -58
  62. package/templates/hooks/mcp-check.md +64 -64
  63. package/templates/hooks/ralph-mcp-logger.sh +46 -46
  64. package/templates/hooks/ralph-session-end.sh +69 -69
  65. package/templates/hooks/stop-hook.sh +177 -177
  66. package/templates/hooks/wsl-dotnet-cleanup.sh +24 -24
  67. package/templates/mcp-scaffolding/component.tsx.hbs +318 -318
  68. package/templates/mcp-scaffolding/controller.cs.hbs +192 -192
  69. package/templates/mcp-scaffolding/entity-extension.cs.hbs +239 -239
  70. package/templates/mcp-scaffolding/frontend/api-client.ts.hbs +116 -116
  71. package/templates/mcp-scaffolding/frontend/nav-routes.ts.hbs +133 -133
  72. package/templates/mcp-scaffolding/frontend/routes.tsx.hbs +126 -126
  73. package/templates/mcp-scaffolding/migrations/seed-roles.cs.hbs +261 -261
  74. package/templates/mcp-scaffolding/service-extension.cs.hbs +53 -53
  75. package/templates/mcp-scaffolding/tests/controller.test.cs.hbs +436 -436
  76. package/templates/mcp-scaffolding/tests/entity.test.cs.hbs +239 -239
  77. package/templates/mcp-scaffolding/tests/repository.test.cs.hbs +441 -441
  78. package/templates/mcp-scaffolding/tests/security.test.cs.hbs +442 -442
  79. package/templates/mcp-scaffolding/tests/service.test.cs.hbs +402 -402
  80. package/templates/mcp-scaffolding/tests/validator.test.cs.hbs +428 -428
  81. package/templates/project/DependencyInjection.Application.cs.template +25 -25
  82. package/templates/project/DependencyInjection.Infrastructure.cs.template +61 -61
  83. package/templates/project/DesignTimeExtensionsDbContextFactory.cs.template +70 -70
  84. package/templates/project/ExampleEntity.cs.template +116 -116
  85. package/templates/project/ExampleEntityConfiguration.cs.template +64 -64
  86. package/templates/project/ExampleService.cs.template +146 -146
  87. package/templates/project/ExtensionsDbContext.cs.template +41 -41
  88. package/templates/project/IExtensionsDbContext.cs.template +22 -22
  89. package/templates/project/Program.cs.template +47 -47
  90. package/templates/project/README.md +79 -79
  91. package/templates/project/api.ts.template +12 -12
  92. package/templates/project/appsettings.json.template +170 -170
  93. package/templates/project/claude-settings.json.template +5 -5
  94. package/templates/project/test-frontend/msw/handlers.ts +58 -58
  95. package/templates/project/test-frontend/msw/server.ts +25 -25
  96. package/templates/project/test-frontend/setup.ts +16 -16
  97. package/templates/project/test-frontend/test-utils.tsx +59 -59
  98. package/templates/project/test-frontend/vitest.config.ts +31 -31
  99. package/templates/ralph/README.md +93 -93
  100. package/templates/ralph/ralph.config.yaml +113 -113
  101. package/templates/scripts/setup-ralph-loop.sh +173 -173
  102. package/templates/skills/_resources/config-safety.md +61 -61
  103. package/templates/skills/_resources/context-digest-template.md +53 -53
  104. package/templates/skills/_resources/doc-context-cache.md +60 -60
  105. package/templates/skills/_resources/docs-manifest-schema.md +155 -155
  106. package/templates/skills/_resources/formatting-guide.md +124 -124
  107. package/templates/skills/_resources/mcp-validate-documentation-spec.md +181 -181
  108. package/templates/skills/_shared.md +228 -228
  109. package/templates/skills/admin/SKILL.md +48 -48
  110. package/templates/skills/ai-prompt/SKILL.md +107 -107
  111. package/templates/skills/ai-prompt/steps/step-00-init.md +47 -47
  112. package/templates/skills/ai-prompt/steps/step-01-implementation.md +122 -122
  113. package/templates/skills/apex/SKILL.md +168 -168
  114. package/templates/skills/apex/_shared.md +141 -141
  115. package/templates/skills/apex/references/agent-teams-protocol.md +164 -164
  116. package/templates/skills/apex/references/analysis-methods.md +141 -141
  117. package/templates/skills/apex/references/challenge-questions.md +145 -145
  118. package/templates/skills/apex/references/code-generation.md +412 -412
  119. package/templates/skills/apex/references/core-seed-data.md +1437 -1437
  120. package/templates/skills/apex/references/error-classification.md +144 -144
  121. package/templates/skills/apex/references/examine-build-validation.md +82 -82
  122. package/templates/skills/apex/references/execution-frontend-gates.md +177 -177
  123. package/templates/skills/apex/references/execution-frontend-patterns.md +105 -105
  124. package/templates/skills/apex/references/execution-layer1-rules.md +96 -96
  125. package/templates/skills/apex/references/initialization-challenge-flow.md +110 -110
  126. package/templates/skills/apex/references/planning-layer-mapping.md +151 -151
  127. package/templates/skills/apex/references/post-checks.md +1584 -1584
  128. package/templates/skills/apex/references/smartstack-api.md +1053 -1053
  129. package/templates/skills/apex/references/smartstack-frontend.md +1571 -1571
  130. package/templates/skills/apex/references/smartstack-layers.md +402 -402
  131. package/templates/skills/apex/steps/step-00-init.md +307 -307
  132. package/templates/skills/apex/steps/step-01-analyze.md +165 -165
  133. package/templates/skills/apex/steps/step-02-plan.md +144 -144
  134. package/templates/skills/apex/steps/step-03-execute.md +328 -328
  135. package/templates/skills/apex/steps/step-04-examine.md +263 -263
  136. package/templates/skills/apex/steps/step-05-deep-review.md +129 -129
  137. package/templates/skills/apex/steps/step-06-resolve.md +101 -101
  138. package/templates/skills/apex/steps/step-07-tests.md +238 -238
  139. package/templates/skills/apex/steps/step-08-run-tests.md +125 -125
  140. package/templates/skills/application/SKILL.md +4 -4
  141. package/templates/skills/application/references/application-roles-template.md +227 -227
  142. package/templates/skills/application/references/backend-controller-hierarchy.md +58 -58
  143. package/templates/skills/application/references/backend-entity-seeding.md +72 -72
  144. package/templates/skills/application/references/backend-seeding-and-dto-output.md +83 -83
  145. package/templates/skills/application/references/backend-table-prefix-mapping.md +79 -79
  146. package/templates/skills/application/references/backend-verification.md +88 -88
  147. package/templates/skills/application/references/frontend-i18n-and-output.md +67 -67
  148. package/templates/skills/application/references/frontend-route-naming.md +117 -117
  149. package/templates/skills/application/references/frontend-route-wiring-app-tsx.md +107 -107
  150. package/templates/skills/application/references/frontend-verification.md +156 -156
  151. package/templates/skills/application/references/migration-checklist-troubleshooting.md +1 -1
  152. package/templates/skills/application/references/provider-template.md +177 -177
  153. package/templates/skills/application/references/roles-client-project-handling.md +55 -55
  154. package/templates/skills/application/references/roles-fallback-procedure.md +149 -149
  155. package/templates/skills/application/references/test-coverage-requirements.md +213 -213
  156. package/templates/skills/application/references/test-frontend.md +73 -73
  157. package/templates/skills/application/references/test-prerequisites.md +72 -72
  158. package/templates/skills/application/steps/step-05-frontend.md +176 -176
  159. package/templates/skills/application/steps/step-06-migration.md +193 -193
  160. package/templates/skills/application/steps/step-07-tests.md +356 -356
  161. package/templates/skills/application/steps/step-08-documentation.md +137 -137
  162. package/templates/skills/application/templates-backend.md +463 -463
  163. package/templates/skills/application/templates-frontend.md +685 -685
  164. package/templates/skills/application/templates-i18n.md +520 -520
  165. package/templates/skills/application/templates-seed.md +1096 -1096
  166. package/templates/skills/business-analyse/SKILL.md +327 -327
  167. package/templates/skills/business-analyse/_architecture.md +123 -123
  168. package/templates/skills/business-analyse/_elicitation.md +206 -206
  169. package/templates/skills/business-analyse/_module-loop.md +115 -115
  170. package/templates/skills/business-analyse/_shared.md +383 -383
  171. package/templates/skills/business-analyse/_suggestions.md +34 -34
  172. package/templates/skills/business-analyse/html/ba-interactive.html +4477 -4477
  173. package/templates/skills/business-analyse/html/build-html.js +77 -77
  174. package/templates/skills/business-analyse/html/src/scripts/01-data-init.js +150 -150
  175. package/templates/skills/business-analyse/html/src/scripts/02-navigation.js +227 -227
  176. package/templates/skills/business-analyse/html/src/scripts/03-render-cadrage.js +199 -199
  177. package/templates/skills/business-analyse/html/src/scripts/04-render-modules.js +205 -205
  178. package/templates/skills/business-analyse/html/src/scripts/05-render-specs.js +647 -647
  179. package/templates/skills/business-analyse/html/src/scripts/06-render-consolidation.js +195 -195
  180. package/templates/skills/business-analyse/html/src/scripts/07-render-handoff.js +92 -92
  181. package/templates/skills/business-analyse/html/src/scripts/08-editing.js +135 -135
  182. package/templates/skills/business-analyse/html/src/scripts/09-export.js +168 -168
  183. package/templates/skills/business-analyse/html/src/scripts/10-comments.js +171 -171
  184. package/templates/skills/business-analyse/html/src/scripts/11-review-panel.js +166 -166
  185. package/templates/skills/business-analyse/html/src/styles/01-variables.css +38 -38
  186. package/templates/skills/business-analyse/html/src/styles/02-layout.css +101 -101
  187. package/templates/skills/business-analyse/html/src/styles/03-navigation.css +120 -120
  188. package/templates/skills/business-analyse/html/src/styles/04-cards.css +196 -196
  189. package/templates/skills/business-analyse/html/src/styles/05-modules.css +454 -454
  190. package/templates/skills/business-analyse/html/src/styles/06-wireframes.css +272 -272
  191. package/templates/skills/business-analyse/html/src/styles/07-comments.css +184 -184
  192. package/templates/skills/business-analyse/html/src/styles/08-review-panel.css +241 -241
  193. package/templates/skills/business-analyse/html/src/template.html +516 -516
  194. package/templates/skills/business-analyse/patterns/suggestion-catalog.md +546 -546
  195. package/templates/skills/business-analyse/questionnaire/00-application.md +160 -160
  196. package/templates/skills/business-analyse/questionnaire/00b-project.md +85 -85
  197. package/templates/skills/business-analyse/questionnaire/01-context.md +185 -185
  198. package/templates/skills/business-analyse/questionnaire/02-stakeholders.md +189 -189
  199. package/templates/skills/business-analyse/questionnaire/03-scope.md +164 -164
  200. package/templates/skills/business-analyse/questionnaire/04-data.md +88 -88
  201. package/templates/skills/business-analyse/questionnaire/05-integrations.md +58 -58
  202. package/templates/skills/business-analyse/questionnaire/06-security.md +68 -68
  203. package/templates/skills/business-analyse/questionnaire/07-ui.md +76 -76
  204. package/templates/skills/business-analyse/questionnaire/08-performance.md +42 -42
  205. package/templates/skills/business-analyse/questionnaire/09-constraints.md +45 -45
  206. package/templates/skills/business-analyse/questionnaire/10-documentation.md +43 -43
  207. package/templates/skills/business-analyse/questionnaire/11-data-lifecycle.md +59 -59
  208. package/templates/skills/business-analyse/questionnaire/12-migration.md +58 -58
  209. package/templates/skills/business-analyse/questionnaire/13-cross-module.md +69 -69
  210. package/templates/skills/business-analyse/questionnaire/14-risk-assumptions.md +135 -135
  211. package/templates/skills/business-analyse/questionnaire/15-success-metrics.md +136 -136
  212. package/templates/skills/business-analyse/questionnaire.md +337 -337
  213. package/templates/skills/business-analyse/react/application-viewer.md +242 -242
  214. package/templates/skills/business-analyse/react/components.md +551 -551
  215. package/templates/skills/business-analyse/react/i18n-template.md +306 -306
  216. package/templates/skills/business-analyse/references/acceptance-criteria.md +169 -169
  217. package/templates/skills/business-analyse/references/agent-module-prompt.md +362 -362
  218. package/templates/skills/business-analyse/references/agent-pooling-best-practices.md +557 -557
  219. package/templates/skills/business-analyse/references/analysis-semantic-checks.md +190 -190
  220. package/templates/skills/business-analyse/references/cache-warming-strategy.md +566 -566
  221. package/templates/skills/business-analyse/references/cadrage-challenge-patterns.md +41 -41
  222. package/templates/skills/business-analyse/references/cadrage-coverage-matrix.md +74 -74
  223. package/templates/skills/business-analyse/references/cadrage-pre-analysis.md +115 -115
  224. package/templates/skills/business-analyse/references/cadrage-shared-modules.md +68 -69
  225. package/templates/skills/business-analyse/references/cadrage-structure-cards.md +85 -85
  226. package/templates/skills/business-analyse/references/compilation-structure-cards.md +297 -297
  227. package/templates/skills/business-analyse/references/consolidation-structural-checks.md +107 -107
  228. package/templates/skills/business-analyse/references/deploy-data-build.md +180 -180
  229. package/templates/skills/business-analyse/references/deploy-modes.md +118 -118
  230. package/templates/skills/business-analyse/references/detection-strategies.md +424 -424
  231. package/templates/skills/business-analyse/references/entity-architecture-decision.md +218 -218
  232. package/templates/skills/business-analyse/references/handoff-file-templates.md +120 -120
  233. package/templates/skills/business-analyse/references/handoff-mappings.md +81 -81
  234. package/templates/skills/business-analyse/references/handoff-seeddata-generation.md +312 -312
  235. package/templates/skills/business-analyse/references/html-data-mapping.md +299 -299
  236. package/templates/skills/business-analyse/references/init-schema-deployment.md +65 -65
  237. package/templates/skills/business-analyse/references/naming-conventions.md +243 -243
  238. package/templates/skills/business-analyse/references/prd-generation.md +258 -258
  239. package/templates/skills/business-analyse/references/review-data-mapping.md +363 -363
  240. package/templates/skills/business-analyse/references/robustness-checks.md +542 -542
  241. package/templates/skills/business-analyse/references/spec-auto-inference.md +111 -111
  242. package/templates/skills/business-analyse/references/team-orchestration.md +1022 -1022
  243. package/templates/skills/business-analyse/references/ui-dashboard-spec.md +85 -85
  244. package/templates/skills/business-analyse/references/ui-resource-cards.md +259 -259
  245. package/templates/skills/business-analyse/references/validate-incremental-html.md +121 -121
  246. package/templates/skills/business-analyse/references/validation-checklist.md +347 -347
  247. package/templates/skills/business-analyse/references/wireframe-svg-style-guide.md +335 -335
  248. package/templates/skills/business-analyse/schemas/application-schema.json +453 -453
  249. package/templates/skills/business-analyse/schemas/feature-schema.json +53 -53
  250. package/templates/skills/business-analyse/schemas/project-schema.json +485 -485
  251. package/templates/skills/business-analyse/schemas/sections/analysis-schema.json +201 -201
  252. package/templates/skills/business-analyse/schemas/sections/discovery-schema.json +82 -82
  253. package/templates/skills/business-analyse/schemas/sections/handoff-schema.json +80 -80
  254. package/templates/skills/business-analyse/schemas/sections/metadata-schema.json +70 -70
  255. package/templates/skills/business-analyse/schemas/sections/specification-schema.json +547 -547
  256. package/templates/skills/business-analyse/schemas/sections/validation-schema.json +93 -93
  257. package/templates/skills/business-analyse/schemas/shared/common-defs.json +226 -226
  258. package/templates/skills/business-analyse/steps/step-00-init.md +575 -576
  259. package/templates/skills/business-analyse/steps/step-01-cadrage.md +767 -767
  260. package/templates/skills/business-analyse/steps/step-01b-applications.md +419 -419
  261. package/templates/skills/business-analyse/steps/step-02-decomposition.md +387 -387
  262. package/templates/skills/business-analyse/steps/step-03a-data.md +16 -16
  263. package/templates/skills/business-analyse/steps/step-03a1-setup.md +506 -506
  264. package/templates/skills/business-analyse/steps/step-03a2-analysis.md +252 -252
  265. package/templates/skills/business-analyse/steps/step-03b-ui.md +425 -425
  266. package/templates/skills/business-analyse/steps/step-03c-compile.md +611 -611
  267. package/templates/skills/business-analyse/steps/step-03d-validate.md +783 -783
  268. package/templates/skills/business-analyse/steps/step-04-consolidation.md +17 -17
  269. package/templates/skills/business-analyse/steps/step-04a-collect.md +415 -415
  270. package/templates/skills/business-analyse/steps/step-04b-analyze.md +163 -163
  271. package/templates/skills/business-analyse/steps/step-04c-decide.md +186 -186
  272. package/templates/skills/business-analyse/steps/step-05a-handoff.md +840 -840
  273. package/templates/skills/business-analyse/steps/step-05b-deploy.md +522 -522
  274. package/templates/skills/business-analyse/steps/step-05c-ralph-readiness.md +703 -703
  275. package/templates/skills/business-analyse/steps/step-06-review.md +278 -278
  276. package/templates/skills/business-analyse/templates/tpl-frd.md +168 -168
  277. package/templates/skills/business-analyse/templates/tpl-handoff.md +186 -186
  278. package/templates/skills/business-analyse/templates/tpl-launch-displays.md +59 -59
  279. package/templates/skills/business-analyse/templates/tpl-progress.md +172 -172
  280. package/templates/skills/business-analyse/templates-frd.md +476 -476
  281. package/templates/skills/business-analyse/templates-react.md +574 -574
  282. package/templates/skills/cc-agent/SKILL.md +129 -129
  283. package/templates/skills/cc-agent/references/agent-behavior-patterns.md +95 -95
  284. package/templates/skills/cc-agent/references/agent-frontmatter.md +213 -213
  285. package/templates/skills/cc-agent/references/permission-modes.md +102 -102
  286. package/templates/skills/cc-agent/references/tools-reference.md +144 -144
  287. package/templates/skills/cc-agent/steps/step-00-init.md +134 -134
  288. package/templates/skills/cc-agent/steps/step-01-design.md +186 -186
  289. package/templates/skills/cc-agent/steps/step-02-generate.md +131 -131
  290. package/templates/skills/cc-agent/steps/step-03-validate.md +130 -130
  291. package/templates/skills/cc-agent/templates/agent-categorized.md +67 -67
  292. package/templates/skills/cc-agent/templates/agent-standalone.md +56 -56
  293. package/templates/skills/cc-agent/templates/agent-with-skills.md +94 -94
  294. package/templates/skills/cc-audit/SKILL.md +108 -108
  295. package/templates/skills/cc-audit/references/agent-checklist.md +91 -91
  296. package/templates/skills/cc-audit/references/hook-checklist.md +110 -110
  297. package/templates/skills/cc-audit/references/skill-checklist.md +70 -70
  298. package/templates/skills/cc-audit/steps/step-00-init.md +98 -98
  299. package/templates/skills/cc-audit/steps/step-01-scan.md +142 -142
  300. package/templates/skills/cc-audit/steps/step-02-analyze.md +158 -158
  301. package/templates/skills/cc-audit/steps/step-03-report.md +142 -142
  302. package/templates/skills/cc-skill/SKILL.md +134 -134
  303. package/templates/skills/cc-skill/references/best-practices.md +167 -167
  304. package/templates/skills/cc-skill/references/frontmatter-reference.md +182 -182
  305. package/templates/skills/cc-skill/references/skill-patterns.md +199 -199
  306. package/templates/skills/cc-skill/steps/step-00-init.md +119 -119
  307. package/templates/skills/cc-skill/steps/step-01-design.md +199 -199
  308. package/templates/skills/cc-skill/steps/step-02-generate.md +145 -145
  309. package/templates/skills/cc-skill/steps/step-03-steps.md +151 -151
  310. package/templates/skills/cc-skill/steps/step-04-validate.md +124 -124
  311. package/templates/skills/cc-skill/templates/skill-forked.md +85 -85
  312. package/templates/skills/cc-skill/templates/skill-progressive.md +102 -102
  313. package/templates/skills/cc-skill/templates/skill-simple.md +75 -75
  314. package/templates/skills/cc-skill/templates/step-template.md +82 -82
  315. package/templates/skills/check-version/SKILL.md +196 -196
  316. package/templates/skills/controller/SKILL.md +162 -162
  317. package/templates/skills/controller/postman-templates.md +614 -614
  318. package/templates/skills/controller/references/controller-code-templates.md +159 -159
  319. package/templates/skills/controller/references/mcp-scaffold-workflow.md +209 -209
  320. package/templates/skills/controller/references/permission-sync-templates.md +149 -149
  321. package/templates/skills/controller/steps/step-00-init.md +193 -191
  322. package/templates/skills/controller/steps/step-01-analyze.md +146 -146
  323. package/templates/skills/controller/steps/step-02-plan.md +176 -176
  324. package/templates/skills/controller/steps/step-03-generate.md +189 -189
  325. package/templates/skills/controller/steps/step-04-perms.md +80 -80
  326. package/templates/skills/controller/steps/step-05-validate.md +107 -107
  327. package/templates/skills/controller/templates.md +1555 -1555
  328. package/templates/skills/debug/SKILL.md +70 -70
  329. package/templates/skills/debug/references/team-protocol.md +232 -232
  330. package/templates/skills/debug/steps/step-00-init.md +57 -57
  331. package/templates/skills/debug/steps/step-01-analyze.md +219 -219
  332. package/templates/skills/debug/steps/step-02-resolve.md +85 -85
  333. package/templates/skills/documentation/SKILL.md +132 -132
  334. package/templates/skills/documentation/data-schema.md +227 -227
  335. package/templates/skills/documentation/steps/step-00-init.md +70 -70
  336. package/templates/skills/documentation/steps/step-01-scan.md +113 -113
  337. package/templates/skills/documentation/steps/step-02-generate.md +231 -231
  338. package/templates/skills/documentation/steps/step-03-validate.md +251 -238
  339. package/templates/skills/documentation/templates.md +662 -663
  340. package/templates/skills/efcore/SKILL.md +168 -167
  341. package/templates/skills/efcore/references/both-contexts.md +32 -32
  342. package/templates/skills/efcore/references/database-operations.md +67 -67
  343. package/templates/skills/efcore/references/destructive-operations.md +38 -38
  344. package/templates/skills/efcore/references/reset-operations.md +81 -81
  345. package/templates/skills/efcore/references/seed-methods.md +86 -86
  346. package/templates/skills/efcore/references/shared-init-functions.md +250 -250
  347. package/templates/skills/efcore/references/sql-objects-injection.md +61 -61
  348. package/templates/skills/efcore/references/troubleshooting.md +81 -81
  349. package/templates/skills/efcore/references/zero-downtime-patterns.md +227 -227
  350. package/templates/skills/efcore/steps/db/step-deploy.md +217 -217
  351. package/templates/skills/efcore/steps/db/step-reset.md +186 -186
  352. package/templates/skills/efcore/steps/db/step-seed.md +166 -166
  353. package/templates/skills/efcore/steps/db/step-status.md +173 -173
  354. package/templates/skills/efcore/steps/migration/step-00-init.md +102 -102
  355. package/templates/skills/efcore/steps/migration/step-01-check.md +164 -164
  356. package/templates/skills/efcore/steps/migration/step-02-create.md +160 -160
  357. package/templates/skills/efcore/steps/migration/step-03-validate.md +168 -168
  358. package/templates/skills/efcore/steps/rebase-snapshot/step-00-init.md +173 -173
  359. package/templates/skills/efcore/steps/rebase-snapshot/step-01-backup.md +100 -100
  360. package/templates/skills/efcore/steps/rebase-snapshot/step-02-fetch.md +115 -115
  361. package/templates/skills/efcore/steps/rebase-snapshot/step-03-create.md +112 -112
  362. package/templates/skills/efcore/steps/rebase-snapshot/step-04-validate.md +157 -157
  363. package/templates/skills/efcore/steps/shared/step-00-init.md +131 -131
  364. package/templates/skills/efcore/steps/squash/step-00-init.md +141 -141
  365. package/templates/skills/efcore/steps/squash/step-01-backup.md +120 -120
  366. package/templates/skills/efcore/steps/squash/step-02-fetch.md +168 -168
  367. package/templates/skills/efcore/steps/squash/step-03-create.md +184 -184
  368. package/templates/skills/efcore/steps/squash/step-04-validate.md +174 -174
  369. package/templates/skills/explore/SKILL.md +98 -98
  370. package/templates/skills/feature-full/SKILL.md +111 -111
  371. package/templates/skills/feature-full/steps/step-00-init.md +57 -57
  372. package/templates/skills/feature-full/steps/step-01-implementation.md +120 -120
  373. package/templates/skills/gitflow/SKILL.md +377 -377
  374. package/templates/skills/gitflow/_shared.md +620 -620
  375. package/templates/skills/gitflow/phases/abort.md +189 -189
  376. package/templates/skills/gitflow/phases/cleanup.md +234 -234
  377. package/templates/skills/gitflow/phases/status.md +192 -192
  378. package/templates/skills/gitflow/references/commit-message-generation.md +58 -58
  379. package/templates/skills/gitflow/references/commit-migration-validation.md +49 -49
  380. package/templates/skills/gitflow/references/finish-cleanup.md +55 -55
  381. package/templates/skills/gitflow/references/finish-version-bumping.md +45 -45
  382. package/templates/skills/gitflow/references/init-config-template.md +135 -135
  383. package/templates/skills/gitflow/references/init-environment-detection.md +41 -41
  384. package/templates/skills/gitflow/references/init-name-normalization.md +103 -103
  385. package/templates/skills/gitflow/references/init-questions.md +185 -185
  386. package/templates/skills/gitflow/references/init-structure-creation.md +75 -75
  387. package/templates/skills/gitflow/references/init-version-detection.md +21 -21
  388. package/templates/skills/gitflow/references/init-workspace-detection.md +43 -43
  389. package/templates/skills/gitflow/references/merge-ci-status.md +36 -36
  390. package/templates/skills/gitflow/references/merge-execution.md +62 -62
  391. package/templates/skills/gitflow/references/merge-pr-context.md +76 -76
  392. package/templates/skills/gitflow/references/plan-template.md +69 -69
  393. package/templates/skills/gitflow/references/pr-build-checks.md +60 -60
  394. package/templates/skills/gitflow/references/pr-generation.md +58 -58
  395. package/templates/skills/gitflow/references/start-branch-normalization.md +28 -28
  396. package/templates/skills/gitflow/references/start-efcore-preflight.md +70 -70
  397. package/templates/skills/gitflow/references/start-local-config.md +113 -113
  398. package/templates/skills/gitflow/references/start-worktree-creation.md +50 -50
  399. package/templates/skills/gitflow/references/sync-push-verify.md +44 -44
  400. package/templates/skills/gitflow/references/sync-rebase-conflicts.md +38 -38
  401. package/templates/skills/gitflow/steps/step-commit.md +199 -199
  402. package/templates/skills/gitflow/steps/step-finish.md +147 -147
  403. package/templates/skills/gitflow/steps/step-init.md +190 -190
  404. package/templates/skills/gitflow/steps/step-merge.md +85 -85
  405. package/templates/skills/gitflow/steps/step-plan.md +151 -151
  406. package/templates/skills/gitflow/steps/step-pr.md +199 -199
  407. package/templates/skills/gitflow/steps/step-start.md +195 -195
  408. package/templates/skills/gitflow/steps/step-sync.md +161 -161
  409. package/templates/skills/gitflow/templates/config.json +72 -72
  410. package/templates/skills/mcp/SKILL.md +62 -62
  411. package/templates/skills/mcp/steps/step-01-healthcheck.md +108 -108
  412. package/templates/skills/mcp/steps/step-02-tools.md +73 -73
  413. package/templates/skills/notification/SKILL.md +173 -173
  414. package/templates/skills/quick-search/SKILL.md +99 -99
  415. package/templates/skills/ralph-loop/SKILL.md +234 -234
  416. package/templates/skills/ralph-loop/references/category-completeness.md +185 -185
  417. package/templates/skills/ralph-loop/references/category-rules.md +96 -96
  418. package/templates/skills/ralph-loop/references/compact-loop.md +300 -300
  419. package/templates/skills/ralph-loop/references/init-resume-recovery.md +127 -127
  420. package/templates/skills/ralph-loop/references/module-transition.md +151 -151
  421. package/templates/skills/ralph-loop/references/multi-module-queue.md +171 -171
  422. package/templates/skills/ralph-loop/references/parallel-execution.md +246 -246
  423. package/templates/skills/ralph-loop/references/section-splitting.md +439 -439
  424. package/templates/skills/ralph-loop/references/task-transform-legacy.md +256 -256
  425. package/templates/skills/ralph-loop/references/team-orchestration.md +547 -547
  426. package/templates/skills/ralph-loop/steps/step-00-init.md +150 -150
  427. package/templates/skills/ralph-loop/steps/step-01-task.md +174 -174
  428. package/templates/skills/ralph-loop/steps/step-02-execute.md +177 -177
  429. package/templates/skills/ralph-loop/steps/step-03-commit.md +92 -92
  430. package/templates/skills/ralph-loop/steps/step-04-check.md +207 -207
  431. package/templates/skills/ralph-loop/steps/step-05-report.md +175 -175
  432. package/templates/skills/refactor/SKILL.md +56 -56
  433. package/templates/skills/refactor/steps/step-01-discover.md +60 -60
  434. package/templates/skills/refactor/steps/step-02-execute.md +67 -67
  435. package/templates/skills/review-code/SKILL.md +95 -94
  436. package/templates/skills/review-code/references/clean-code-principles.md +292 -292
  437. package/templates/skills/review-code/references/code-quality-metrics.md +174 -174
  438. package/templates/skills/review-code/references/feedback-patterns.md +149 -149
  439. package/templates/skills/review-code/references/owasp-api-top10.md +243 -243
  440. package/templates/skills/review-code/references/security-checklist.md +212 -212
  441. package/templates/skills/review-code/steps/step-01-smartstack.md +96 -96
  442. package/templates/skills/review-code/steps/step-02-detailed-review.md +80 -80
  443. package/templates/skills/review-code/steps/step-03-react.md +44 -44
  444. package/templates/skills/ui-components/SKILL.md +137 -137
  445. package/templates/skills/ui-components/accessibility.md +170 -170
  446. package/templates/skills/ui-components/patterns/dashboard-chart.md +327 -327
  447. package/templates/skills/ui-components/patterns/data-table.md +39 -39
  448. package/templates/skills/ui-components/patterns/entity-card.md +77 -77
  449. package/templates/skills/ui-components/patterns/grid-layout.md +91 -91
  450. package/templates/skills/ui-components/patterns/kanban.md +43 -43
  451. package/templates/skills/ui-components/responsive-guidelines.md +278 -278
  452. package/templates/skills/ui-components/style-guide.md +113 -113
  453. package/templates/skills/utils/SKILL.md +44 -44
  454. package/templates/skills/utils/subcommands/test-web-config.md +152 -152
  455. package/templates/skills/utils/subcommands/test-web.md +123 -123
  456. package/templates/skills/validate/SKILL.md +181 -181
  457. package/templates/skills/validate-feature/SKILL.md +101 -101
  458. package/templates/skills/validate-feature/references/api-smoke-tests.md +140 -140
  459. package/templates/skills/validate-feature/references/db-validation-checks.md +180 -180
  460. package/templates/skills/validate-feature/steps/step-00-dependencies.md +121 -121
  461. package/templates/skills/validate-feature/steps/step-01-compile.md +39 -39
  462. package/templates/skills/validate-feature/steps/step-02-unit-tests.md +45 -45
  463. package/templates/skills/validate-feature/steps/step-03-integration-tests.md +53 -53
  464. package/templates/skills/validate-feature/steps/step-04-api-smoke.md +94 -94
  465. package/templates/skills/validate-feature/steps/step-05-db-validation.md +149 -149
  466. package/templates/skills/workflow/SKILL.md +127 -127
  467. package/templates/skills/workflow/steps/step-00-init.md +57 -57
  468. package/templates/skills/workflow/steps/step-01-implementation.md +84 -84
  469. package/templates/test-web/api-health.json +38 -38
  470. package/templates/test-web/minimal.json +19 -19
  471. package/templates/test-web/npm-package.json +46 -46
  472. package/templates/test-web/seo-check.json +54 -54
@@ -1,41 +1,41 @@
1
- # Cadrage Challenge Patterns
2
-
3
- Reference material for identifying and challenging implicit assumptions in business requirements analysis.
4
-
5
- ## Challenge Question Examples by Domain Pattern
6
-
7
- | Brief statement | Implicit assumption | Challenge question |
8
- |----------------|--------------------|--------------------|
9
- | "Entities are 1:1 extensions of X" | Cardinality is always 1:1 | "Can a user be linked to multiple employee records (temp contracts, part-time multi-position)? Can an employee NOT have a user account?" |
10
- | "Entry split into activity and absence" | Binary decomposition is sufficient | "What granularity? Day, half-day, hour? Are activities linked to projects or clients? Are there other entry types (training, travel, on-call)?" |
11
- | "A reports section" | Reports are a simple addition | "Which reports exactly? For whom? How often? PDF/Excel export? Real-time dashboards? Aggregated or detailed?" |
12
- | "Module X manages Y" | The scope of "manages" is clear | "What does 'manage' mean concretely? Create, read, update, delete? Approve? Archive? Import/export?" |
13
-
14
- ## Elicitation Techniques
15
-
16
- **Technique 3 (Concrete Scenario):** "Walk me through a typical day of [role] using this module"
17
-
18
- **Technique 4 (Absence Test):** "If [feature] didn't exist, how would you handle it?"
19
-
20
- **Technique 8 (Impact Escalation):** "With 50 records this works, but with 500? 5000? Does the process stay the same?"
21
-
22
- ## MoSCoW Prioritization Template
23
-
24
- When client classifies ALL features as "must-have", apply this blocking challenge:
25
-
26
- ```
27
- question: "{language == 'fr'
28
- ? 'Toutes les fonctionnalités sont marquées indispensables. Si vous ne pouviez livrer que 60% du périmètre en v1, lesquelles pourraient attendre la v2 ?'
29
- : 'All features are marked must-have. If you could only deliver 60% of scope in v1, which ones could wait for v2?'}"
30
- header: "Priorisation"
31
- multiSelect: true
32
- options:
33
- - label: "{feature_1}"
34
- description: "{language == 'fr' ? 'Pourrait passer en Important (v1.x)' : 'Could move to Important (v1.x)'}"
35
- - label: "{feature_2}"
36
- description: "{language == 'fr' ? 'Pourrait passer en Optionnel (v2)' : 'Could move to Optional (v2)'}"
37
- - label: "{language == 'fr' ? 'Tout est vraiment indispensable' : 'Everything is truly must-have'}"
38
- description: "{language == 'fr' ? 'Je confirme que toutes les fonctionnalités sont critiques pour la v1' : 'I confirm all features are critical for v1'}"
39
- ```
40
-
41
- If client moves items → update categories. If client confirms ALL mustHave → accept but log in changelog.
1
+ # Cadrage Challenge Patterns
2
+
3
+ Reference material for identifying and challenging implicit assumptions in business requirements analysis.
4
+
5
+ ## Challenge Question Examples by Domain Pattern
6
+
7
+ | Brief statement | Implicit assumption | Challenge question |
8
+ |----------------|--------------------|--------------------|
9
+ | "Entities are 1:1 extensions of X" | Cardinality is always 1:1 | "Can a user be linked to multiple employee records (temp contracts, part-time multi-position)? Can an employee NOT have a user account?" |
10
+ | "Entry split into activity and absence" | Binary decomposition is sufficient | "What granularity? Day, half-day, hour? Are activities linked to projects or clients? Are there other entry types (training, travel, on-call)?" |
11
+ | "A reports section" | Reports are a simple addition | "Which reports exactly? For whom? How often? PDF/Excel export? Real-time dashboards? Aggregated or detailed?" |
12
+ | "Module X manages Y" | The scope of "manages" is clear | "What does 'manage' mean concretely? Create, read, update, delete? Approve? Archive? Import/export?" |
13
+
14
+ ## Elicitation Techniques
15
+
16
+ **Technique 3 (Concrete Scenario):** "Walk me through a typical day of [role] using this module"
17
+
18
+ **Technique 4 (Absence Test):** "If [feature] didn't exist, how would you handle it?"
19
+
20
+ **Technique 8 (Impact Escalation):** "With 50 records this works, but with 500? 5000? Does the process stay the same?"
21
+
22
+ ## MoSCoW Prioritization Template
23
+
24
+ When client classifies ALL features as "must-have", apply this blocking challenge:
25
+
26
+ ```
27
+ question: "{language == 'fr'
28
+ ? 'Toutes les fonctionnalités sont marquées indispensables. Si vous ne pouviez livrer que 60% du périmètre en v1, lesquelles pourraient attendre la v2 ?'
29
+ : 'All features are marked must-have. If you could only deliver 60% of scope in v1, which ones could wait for v2?'}"
30
+ header: "Priorisation"
31
+ multiSelect: true
32
+ options:
33
+ - label: "{feature_1}"
34
+ description: "{language == 'fr' ? 'Pourrait passer en Important (v1.x)' : 'Could move to Important (v1.x)'}"
35
+ - label: "{feature_2}"
36
+ description: "{language == 'fr' ? 'Pourrait passer en Optionnel (v2)' : 'Could move to Optional (v2)'}"
37
+ - label: "{language == 'fr' ? 'Tout est vraiment indispensable' : 'Everything is truly must-have'}"
38
+ description: "{language == 'fr' ? 'Je confirme que toutes les fonctionnalités sont critiques pour la v1' : 'I confirm all features are critical for v1'}"
39
+ ```
40
+
41
+ If client moves items → update categories. If client confirms ALL mustHave → accept but log in changelog.
@@ -1,74 +1,74 @@
1
- # Coverage Matrix with Sections & Resources
2
-
3
- Reference for building and validating the coverage matrix that maps requirements to modules, sections, and resources.
4
-
5
- ## Section Rule (CRITICAL)
6
-
7
- Sections are functional zones (list, dashboard, approve, import, rapport...).
8
- - `create` and `edit` are SEPARATE PAGES with their own URL routes (`/create` and `/:id/edit`)
9
- - `detail` is a page with tabs accessible by clicking a row in `list`, NOT a standalone section
10
-
11
- ## Coverage Matrix Template
12
-
13
- Print a markdown table with columns: **Fonctionnalité | Priorité | Module | Section | Resources clés | Onglets détail**
14
-
15
- ### Example
16
-
17
- ```
18
- | Fonctionnalité | Priorité | Module | Section | Resources clés | Onglets détail |
19
- |---|---|---|---|---|---|
20
- | Gestion des employés | mustHave | Employees | list | employee-grid, employee-filters, employee-form | Infos, Contrats, Documents |
21
- | Suivi des activités | mustHave | TimeTracking | list | activity-grid, activity-filters, activity-form | Infos, Imputations |
22
- | Saisie d'absences | mustHave | TimeTracking | list | absence-grid, absence-form, absence-calendar | Infos, Justificatifs |
23
- | Rapports temps | shouldHave | TimeTracking | dashboard | time-kpi-cards, time-summary-chart | — |
24
- | Validation absences | shouldHave | TimeTracking | approve | approval-queue, status-timeline | — |
25
- | Export PDF/Excel | couldHave | TimeTracking | rapport | export-panel | — |
26
- | Intégration paie | outOfScope | — | — | — | — |
27
- ```
28
-
29
- ## Priority Distribution POST-CHECK (BLOCKING)
30
-
31
- ```javascript
32
- coverageItems = cadrage.coverageMatrix[]
33
- mustHaveCount = coverageItems.filter(i => i.category === "mustHave").length
34
- shouldHaveCount = coverageItems.filter(i => i.category === "shouldHave").length
35
- couldHaveCount = coverageItems.filter(i => i.category === "couldHave").length
36
- outOfScopeCount = coverageItems.filter(i => i.category === "outOfScope").length
37
-
38
- IF shouldHaveCount === 0 AND couldHaveCount === 0 AND outOfScopeCount === 0:
39
- → FAIL: ALL {mustHaveCount} items are mustHave — no distribution.
40
- → ACTION: Return to Phase 3 section 4c and apply MoSCoW question.
41
- → DO NOT write cadrage until at least shouldHave OR outOfScope has ≥ 1 item.
42
- → EXCEPTION: If client explicitly confirmed "tout est indispensable" during
43
- Phase 3 section 4c, accept but ADD a changelog entry:
44
- "Client confirmed all {N} features as mustHave after MoSCoW challenge"
45
- ```
46
-
47
- ## Cross-Cutting Coverage POST-CHECK (WARNING)
48
-
49
- ```javascript
50
- FOR each item in coverageMatrix WHERE item.module === null:
51
- IF item.category === "mustHave":
52
- → WARNING: "{item.item}" is mustHave but has no assigned module.
53
- → Ensure it is covered by infrastructure or a cross-cutting concern.
54
- → Add a note explaining HOW it will be implemented (e.g., "handled by platform notification service").
55
- IF item.anticipatedSections.length === 0 AND item.category !== "outOfScope":
56
- → WARNING: "{item.item}" has no anticipated sections — will it be implemented?
57
- ```
58
-
59
- ## Building Coverage Matrix from Feature Analysis
60
-
61
- For EACH distinct feature/requirement identified during phases 2-4:
62
-
63
- 1. Create an entry in `cadrage.coverageMatrix[]`
64
- 2. Assign it to mustHave, shouldHave, couldHave, or outOfScope
65
- 3. Assign the module that will cover it (or null if cross-cutting)
66
- 4. **List anticipated sections** (Level 4) — ONLY functional zones
67
- 5. **List anticipated resources** (Level 5) for each section
68
- 6. **List detail page tabs** — for entities accessible via click from `list`
69
-
70
- ### Validation
71
-
72
- - Every line of the original prompt must map to at least one coverageMatrix entry.
73
- - If a feature is in mustHave → it MUST have at least one anticipated section.
74
- - Accepted suggestions from Phase 4 must appear in the matrix.
1
+ # Coverage Matrix with Sections & Resources
2
+
3
+ Reference for building and validating the coverage matrix that maps requirements to modules, sections, and resources.
4
+
5
+ ## Section Rule (CRITICAL)
6
+
7
+ Sections are functional zones (list, dashboard, approve, import, rapport...).
8
+ - `create` and `edit` are SEPARATE PAGES with their own URL routes (`/create` and `/:id/edit`)
9
+ - `detail` is a page with tabs accessible by clicking a row in `list`, NOT a standalone section
10
+
11
+ ## Coverage Matrix Template
12
+
13
+ Print a markdown table with columns: **Fonctionnalité | Priorité | Module | Section | Resources clés | Onglets détail**
14
+
15
+ ### Example
16
+
17
+ ```
18
+ | Fonctionnalité | Priorité | Module | Section | Resources clés | Onglets détail |
19
+ |---|---|---|---|---|---|
20
+ | Gestion des employés | mustHave | Employees | list | employee-grid, employee-filters, employee-form | Infos, Contrats, Documents |
21
+ | Suivi des activités | mustHave | TimeTracking | list | activity-grid, activity-filters, activity-form | Infos, Imputations |
22
+ | Saisie d'absences | mustHave | TimeTracking | list | absence-grid, absence-form, absence-calendar | Infos, Justificatifs |
23
+ | Rapports temps | shouldHave | TimeTracking | dashboard | time-kpi-cards, time-summary-chart | — |
24
+ | Validation absences | shouldHave | TimeTracking | approve | approval-queue, status-timeline | — |
25
+ | Export PDF/Excel | couldHave | TimeTracking | rapport | export-panel | — |
26
+ | Intégration paie | outOfScope | — | — | — | — |
27
+ ```
28
+
29
+ ## Priority Distribution POST-CHECK (BLOCKING)
30
+
31
+ ```javascript
32
+ coverageItems = cadrage.coverageMatrix[]
33
+ mustHaveCount = coverageItems.filter(i => i.category === "mustHave").length
34
+ shouldHaveCount = coverageItems.filter(i => i.category === "shouldHave").length
35
+ couldHaveCount = coverageItems.filter(i => i.category === "couldHave").length
36
+ outOfScopeCount = coverageItems.filter(i => i.category === "outOfScope").length
37
+
38
+ IF shouldHaveCount === 0 AND couldHaveCount === 0 AND outOfScopeCount === 0:
39
+ → FAIL: ALL {mustHaveCount} items are mustHave — no distribution.
40
+ → ACTION: Return to Phase 3 section 4c and apply MoSCoW question.
41
+ → DO NOT write cadrage until at least shouldHave OR outOfScope has ≥ 1 item.
42
+ → EXCEPTION: If client explicitly confirmed "tout est indispensable" during
43
+ Phase 3 section 4c, accept but ADD a changelog entry:
44
+ "Client confirmed all {N} features as mustHave after MoSCoW challenge"
45
+ ```
46
+
47
+ ## Cross-Cutting Coverage POST-CHECK (WARNING)
48
+
49
+ ```javascript
50
+ FOR each item in coverageMatrix WHERE item.module === null:
51
+ IF item.category === "mustHave":
52
+ → WARNING: "{item.item}" is mustHave but has no assigned module.
53
+ → Ensure it is covered by infrastructure or a cross-cutting concern.
54
+ → Add a note explaining HOW it will be implemented (e.g., "handled by platform notification service").
55
+ IF item.anticipatedSections.length === 0 AND item.category !== "outOfScope":
56
+ → WARNING: "{item.item}" has no anticipated sections — will it be implemented?
57
+ ```
58
+
59
+ ## Building Coverage Matrix from Feature Analysis
60
+
61
+ For EACH distinct feature/requirement identified during phases 2-4:
62
+
63
+ 1. Create an entry in `cadrage.coverageMatrix[]`
64
+ 2. Assign it to mustHave, shouldHave, couldHave, or outOfScope
65
+ 3. Assign the module that will cover it (or null if cross-cutting)
66
+ 4. **List anticipated sections** (Level 4) — ONLY functional zones
67
+ 5. **List anticipated resources** (Level 5) for each section
68
+ 6. **List detail page tabs** — for entities accessible via click from `list`
69
+
70
+ ### Validation
71
+
72
+ - Every line of the original prompt must map to at least one coverageMatrix entry.
73
+ - If a feature is in mustHave → it MUST have at least one anticipated section.
74
+ - Accepted suggestions from Phase 4 must appear in the matrix.
@@ -1,115 +1,115 @@
1
- # Cadrage: Pre-Analysis Reference
2
-
3
- > Reference for step-01-cadrage.md — silent pre-analysis to PREPARE the interactive conversation.
4
- > **This file does NOT replace the conversation — it prepares it.**
5
-
6
- ## Purpose
7
-
8
- Before engaging the client, the AI silently analyzes the `{feature_description}` to:
9
- 1. Understand what was said (extract explicit requirements)
10
- 2. Detect what was NOT said (identify shadow zones to challenge)
11
- 3. Prepare targeted questions (not generic ones)
12
- 4. Pre-identify modules, sections, and resources
13
-
14
- **The output of this pre-analysis is INTERNAL ONLY.** It is never shown directly to the client — it feeds the reformulation (Phase 2) and challenge questions (Phase 3).
15
-
16
- ## Pre-Analysis Rules
17
-
18
- ### 1. Problem Type Inference
19
-
20
- Derive the problem type from `{feature_description}` keywords:
21
-
22
- ```yaml
23
- problem_type:
24
- → Keywords "remplacer", "migrer", "existant" → "replace" (existing tool to replace)
25
- → Keywords "automatiser", "manuel", "processus" → "automate" (manual process to automate)
26
- → Keywords "centraliser", "dispersees", "eparpillees" → "centralize" (data scattered across systems)
27
- → Default (new tool) → "new_tool" (no system in place)
28
- ```
29
-
30
- ### 2. Explicit Module/Feature Extraction
31
-
32
- Extract functional areas explicitly mentioned in the description:
33
-
34
- ```yaml
35
- detected_modules:
36
- → For each distinct functional area mentioned:
37
- - name: "{PascalCase module name}"
38
- - description: "{what the user said about it}"
39
- - detected_sections: ["{inferred sections based on description}"]
40
- - detected_resources: ["{inferred resources}"]
41
- ```
42
-
43
- ### 3. Shadow Zone Detection (CRITICAL)
44
-
45
- > **Shadow zones are the most valuable output of pre-analysis.**
46
- > They become the challenge questions in Phase 3.
47
-
48
- For EACH detected module, check for missing information:
49
-
50
- | What to check | Shadow zone if missing | Challenge question pattern |
51
- |--------------|----------------------|--------------------------|
52
- | Stakeholders | Who uses this module? | "Who interacts with {module} daily? Only {mentioned role} or also managers, admins, external users?" |
53
- | Cardinality | Relationships stated as fact | "You said {A} is 1:1 with {B}. Can {A} exist without {B}? Can {B} have multiple {A}?" |
54
- | Granularity | Level of detail unclear | "What granularity for {feature}? Day, half-day, hour? Single entry or batch?" |
55
- | Reports | Mentioned but not detailed | "Which reports exactly? For whom? What format? How often?" |
56
- | Validation workflow | Actions without approval | "Does {action} require approval? Who validates? What happens if rejected?" |
57
- | Edge cases | Only happy path described | "What happens when {something goes wrong}? When data is incomplete? When two users do it simultaneously?" |
58
- | Non-functional | Security, performance, compliance | "Is there sensitive data (GDPR)? Expected concurrent users? Compliance requirements?" |
59
- | Integration | Standalone or connected | "Does {module} need to exchange data with external systems? Import? Export? API?" |
60
-
61
- ### 4. Domain-Specific Anticipation Patterns
62
-
63
- When the problem domain is identified, pre-load domain-specific needs:
64
-
65
- | Domain keywords | Anticipated needs (suggest in Phase 4) |
66
- |----------------|---------------------------------------|
67
- | RH, employes, personnel | Contrats, competences, organigramme, RGPD, conges, jours feries, calendriers |
68
- | Temps, activites, absences | Granularite saisie, validation manageriale, soldes conges, compteurs, export paie |
69
- | Ventes, commandes, clients | Devis, factures, pipeline, relances, taux conversion, segments client |
70
- | Stock, inventaire, produits | Categories, fournisseurs, seuils reapprovisionnement, mouvements, valorisation |
71
- | Projets, taches, planning | Jalons, ressources, Gantt, charge, budget, risques projet |
72
- | Tickets, support, incidents | SLA, escalade, base connaissances, satisfaction, priorites |
73
- | Documents, GED | Versionning, workflows validation, templates, OCR, archivage legal |
74
-
75
- ### 5. Section & Resource Pre-Identification
76
-
77
- For each detected module, anticipate sections (Level 4) and resources (Level 5) based on feature type:
78
-
79
- | Feature type | Sections (functional zones) | Resources (in list section) | Detail page tabs |
80
- |-------------|---------------------------|---------------------------|------------------|
81
- | data-centric | list | {entity}-grid, {entity}-filters, {entity}-form | Infos, {relations} |
82
- | workflow | list, approve | {entity}-grid, {entity}-filters, {entity}-form, approval-queue | Infos, {relations}, Historique |
83
- | reporting | dashboard | summary-chart, kpi-cards, export-panel | — |
84
- | integration | list | sync-status-grid, config-form, log-viewer | Infos, Config, Logs |
85
-
86
- > **RULE:** Sections = functional zones only (`list`, `dashboard`, `approve`, `import`, `rapport`, `planning`).
87
- > `create`/`edit` = separate pages with own URL routes (`/create` and `/:id/edit`). `detail` = tabbed page reached by clicking a row in `list`.
88
-
89
- **Always check:** Does the user's description imply additional functional sections? (e.g., "reports" → `dashboard`, "calendar view" → `planning`, "approval workflow" → `approve`)
90
-
91
- ## Output Format (Internal Only)
92
-
93
- ```yaml
94
- pre_analysis:
95
- problem_type: "new_tool|replace|automate|centralize"
96
- detected_modules:
97
- - name: "ModuleName"
98
- description: "What the user said"
99
- detected_sections: ["list", "detail", "create"]
100
- detected_resources: ["entity-grid", "entity-form"]
101
- shadow_zones:
102
- - topic: "Cardinality Employee-User"
103
- why_it_matters: "1:1 assumption may not hold for temp workers"
104
- challenge_question: "Can a user be linked to multiple employee records?"
105
- - topic: "Report granularity"
106
- why_it_matters: "Reports mentioned but not specified"
107
- challenge_question: "Which reports exactly? For whom? What format?"
108
- anticipated_suggestions:
109
- - suggestion: "Leave balance management"
110
- justification: "Time tracking without leave balances is incomplete"
111
- module: "TimeTracking"
112
- - suggestion: "GDPR compliance module"
113
- justification: "HR data is personal data under GDPR"
114
- module: "Employees"
115
- ```
1
+ # Cadrage: Pre-Analysis Reference
2
+
3
+ > Reference for step-01-cadrage.md — silent pre-analysis to PREPARE the interactive conversation.
4
+ > **This file does NOT replace the conversation — it prepares it.**
5
+
6
+ ## Purpose
7
+
8
+ Before engaging the client, the AI silently analyzes the `{feature_description}` to:
9
+ 1. Understand what was said (extract explicit requirements)
10
+ 2. Detect what was NOT said (identify shadow zones to challenge)
11
+ 3. Prepare targeted questions (not generic ones)
12
+ 4. Pre-identify modules, sections, and resources
13
+
14
+ **The output of this pre-analysis is INTERNAL ONLY.** It is never shown directly to the client — it feeds the reformulation (Phase 2) and challenge questions (Phase 3).
15
+
16
+ ## Pre-Analysis Rules
17
+
18
+ ### 1. Problem Type Inference
19
+
20
+ Derive the problem type from `{feature_description}` keywords:
21
+
22
+ ```yaml
23
+ problem_type:
24
+ → Keywords "remplacer", "migrer", "existant" → "replace" (existing tool to replace)
25
+ → Keywords "automatiser", "manuel", "processus" → "automate" (manual process to automate)
26
+ → Keywords "centraliser", "dispersees", "eparpillees" → "centralize" (data scattered across systems)
27
+ → Default (new tool) → "new_tool" (no system in place)
28
+ ```
29
+
30
+ ### 2. Explicit Module/Feature Extraction
31
+
32
+ Extract functional areas explicitly mentioned in the description:
33
+
34
+ ```yaml
35
+ detected_modules:
36
+ → For each distinct functional area mentioned:
37
+ - name: "{PascalCase module name}"
38
+ - description: "{what the user said about it}"
39
+ - detected_sections: ["{inferred sections based on description}"]
40
+ - detected_resources: ["{inferred resources}"]
41
+ ```
42
+
43
+ ### 3. Shadow Zone Detection (CRITICAL)
44
+
45
+ > **Shadow zones are the most valuable output of pre-analysis.**
46
+ > They become the challenge questions in Phase 3.
47
+
48
+ For EACH detected module, check for missing information:
49
+
50
+ | What to check | Shadow zone if missing | Challenge question pattern |
51
+ |--------------|----------------------|--------------------------|
52
+ | Stakeholders | Who uses this module? | "Who interacts with {module} daily? Only {mentioned role} or also managers, admins, external users?" |
53
+ | Cardinality | Relationships stated as fact | "You said {A} is 1:1 with {B}. Can {A} exist without {B}? Can {B} have multiple {A}?" |
54
+ | Granularity | Level of detail unclear | "What granularity for {feature}? Day, half-day, hour? Single entry or batch?" |
55
+ | Reports | Mentioned but not detailed | "Which reports exactly? For whom? What format? How often?" |
56
+ | Validation workflow | Actions without approval | "Does {action} require approval? Who validates? What happens if rejected?" |
57
+ | Edge cases | Only happy path described | "What happens when {something goes wrong}? When data is incomplete? When two users do it simultaneously?" |
58
+ | Non-functional | Security, performance, compliance | "Is there sensitive data (GDPR)? Expected concurrent users? Compliance requirements?" |
59
+ | Integration | Standalone or connected | "Does {module} need to exchange data with external systems? Import? Export? API?" |
60
+
61
+ ### 4. Domain-Specific Anticipation Patterns
62
+
63
+ When the problem domain is identified, pre-load domain-specific needs:
64
+
65
+ | Domain keywords | Anticipated needs (suggest in Phase 4) |
66
+ |----------------|---------------------------------------|
67
+ | RH, employes, personnel | Contrats, competences, organigramme, RGPD, conges, jours feries, calendriers |
68
+ | Temps, activites, absences | Granularite saisie, validation manageriale, soldes conges, compteurs, export paie |
69
+ | Ventes, commandes, clients | Devis, factures, pipeline, relances, taux conversion, segments client |
70
+ | Stock, inventaire, produits | Categories, fournisseurs, seuils reapprovisionnement, mouvements, valorisation |
71
+ | Projets, taches, planning | Jalons, ressources, Gantt, charge, budget, risques projet |
72
+ | Tickets, support, incidents | SLA, escalade, base connaissances, satisfaction, priorites |
73
+ | Documents, GED | Versionning, workflows validation, templates, OCR, archivage legal |
74
+
75
+ ### 5. Section & Resource Pre-Identification
76
+
77
+ For each detected module, anticipate sections (Level 4) and resources (Level 5) based on feature type:
78
+
79
+ | Feature type | Sections (functional zones) | Resources (in list section) | Detail page tabs |
80
+ |-------------|---------------------------|---------------------------|------------------|
81
+ | data-centric | list | {entity}-grid, {entity}-filters, {entity}-form | Infos, {relations} |
82
+ | workflow | list, approve | {entity}-grid, {entity}-filters, {entity}-form, approval-queue | Infos, {relations}, Historique |
83
+ | reporting | dashboard | summary-chart, kpi-cards, export-panel | — |
84
+ | integration | list | sync-status-grid, config-form, log-viewer | Infos, Config, Logs |
85
+
86
+ > **RULE:** Sections = functional zones only (`list`, `dashboard`, `approve`, `import`, `rapport`, `planning`).
87
+ > `create`/`edit` = separate pages with own URL routes (`/create` and `/:id/edit`). `detail` = tabbed page reached by clicking a row in `list`.
88
+
89
+ **Always check:** Does the user's description imply additional functional sections? (e.g., "reports" → `dashboard`, "calendar view" → `planning`, "approval workflow" → `approve`)
90
+
91
+ ## Output Format (Internal Only)
92
+
93
+ ```yaml
94
+ pre_analysis:
95
+ problem_type: "new_tool|replace|automate|centralize"
96
+ detected_modules:
97
+ - name: "ModuleName"
98
+ description: "What the user said"
99
+ detected_sections: ["list", "detail", "create"]
100
+ detected_resources: ["entity-grid", "entity-form"]
101
+ shadow_zones:
102
+ - topic: "Cardinality Employee-User"
103
+ why_it_matters: "1:1 assumption may not hold for temp workers"
104
+ challenge_question: "Can a user be linked to multiple employee records?"
105
+ - topic: "Report granularity"
106
+ why_it_matters: "Reports mentioned but not specified"
107
+ challenge_question: "Which reports exactly? For whom? What format?"
108
+ anticipated_suggestions:
109
+ - suggestion: "Leave balance management"
110
+ justification: "Time tracking without leave balances is incomplete"
111
+ module: "TimeTracking"
112
+ - suggestion: "GDPR compliance module"
113
+ justification: "HR data is personal data under GDPR"
114
+ module: "Employees"
115
+ ```
@@ -1,69 +1,68 @@
1
- # Cross-Application Shared Module Detection
2
-
3
- Reference for detecting and extracting shared modules when `workflow_mode = "project"`.
4
-
5
- ## Detection Algorithm
6
-
7
- Build module inventory per candidate application:
8
-
9
- ```javascript
10
- // From candidateApplications (step-00) + enriched by cadrage phases 1-4
11
- const modulesByApp = {};
12
- for (const app of candidate_applications) {
13
- modulesByApp[app.name] = app.modules; // e.g., { "RH": ["Employes", "Conges", "Temps"], "Projet": ["Projets", "Temps"] }
14
- }
15
- ```
16
-
17
- Detect modules appearing in 2+ applications:
18
-
19
- ```javascript
20
- const allModules = Object.values(modulesByApp).flat();
21
- const moduleCounts = {};
22
- for (const mod of allModules) {
23
- const normalized = normalizeModuleName(mod); // "Temps", "Saisie du temps", "Time Tracking" → same concept
24
- moduleCounts[normalized] = (moduleCounts[normalized] || 0) + 1;
25
- }
26
- const sharedModules = Object.entries(moduleCounts)
27
- .filter(([_, count]) => count >= 2)
28
- .map(([name, count]) => ({ name, appearsIn: count, applications: findAppsContaining(name) }));
29
- ```
30
-
31
- ## Extraction Logic
32
-
33
- If shared modules found, propose extraction:
34
-
35
- ```javascript
36
- for (const shared of sharedModules) {
37
- // Create new candidate application
38
- candidate_applications.push({
39
- name: shared.name,
40
- description: `Application transversale pour ${shared.name}`,
41
- modules: [shared.name],
42
- context: "business",
43
- isTransversal: true,
44
- consumedBy: shared.applications
45
- });
46
-
47
- // Remove the shared module from original applications
48
- for (const appName of shared.applications) {
49
- const app = candidate_applications.find(a => a.name === appName);
50
- app.modules = app.modules.filter(m => normalizeModuleName(m) !== shared.name);
51
- app.dependencies = app.dependencies || [];
52
- app.dependencies.push({ target: shared.name, type: "data-dependency" });
53
- }
54
- }
55
- ```
56
-
57
- Update `candidate_applications` in the project feature.json.
58
-
59
- ## Question Template
60
-
61
- ```
62
- question: "{language == 'fr' ? 'Souhaitez-vous extraire les modules partagés en application(s) dédiée(s) ?' : 'Do you want to extract shared modules as dedicated application(s)?'}"
63
- header: "Extraction"
64
- options:
65
- - label: "{language == 'fr' ? 'Oui, extraire' : 'Yes, extract'}"
66
- description: "{language == 'fr' ? 'Créer {sharedModules.length} application(s) transversale(s) supplémentaire(s)' : 'Create {sharedModules.length} additional cross-cutting application(s)'}"
67
- - label: "{language == 'fr' ? 'Non, garder en l\'état' : 'No, keep as-is'}"
68
- description: "{language == 'fr' ? 'Chaque application garde sa propre version du module' : 'Each application keeps its own version of the module'}"
69
- ```
1
+ # Cross-Application Shared Module Detection
2
+
3
+ Reference for detecting and extracting shared modules when `workflow_mode = "project"`.
4
+
5
+ ## Detection Algorithm
6
+
7
+ Build module inventory per candidate application:
8
+
9
+ ```javascript
10
+ // From candidateApplications (step-00) + enriched by cadrage phases 1-4
11
+ const modulesByApp = {};
12
+ for (const app of candidate_applications) {
13
+ modulesByApp[app.name] = app.modules; // e.g., { "RH": ["Employes", "Conges", "Temps"], "Projet": ["Projets", "Temps"] }
14
+ }
15
+ ```
16
+
17
+ Detect modules appearing in 2+ applications:
18
+
19
+ ```javascript
20
+ const allModules = Object.values(modulesByApp).flat();
21
+ const moduleCounts = {};
22
+ for (const mod of allModules) {
23
+ const normalized = normalizeModuleName(mod); // "Temps", "Saisie du temps", "Time Tracking" → same concept
24
+ moduleCounts[normalized] = (moduleCounts[normalized] || 0) + 1;
25
+ }
26
+ const sharedModules = Object.entries(moduleCounts)
27
+ .filter(([_, count]) => count >= 2)
28
+ .map(([name, count]) => ({ name, appearsIn: count, applications: findAppsContaining(name) }));
29
+ ```
30
+
31
+ ## Extraction Logic
32
+
33
+ If shared modules found, propose extraction:
34
+
35
+ ```javascript
36
+ for (const shared of sharedModules) {
37
+ // Create new candidate application
38
+ candidate_applications.push({
39
+ name: shared.name,
40
+ description: `Application transversale pour ${shared.name}`,
41
+ modules: [shared.name],
42
+ isTransversal: true,
43
+ consumedBy: shared.applications
44
+ });
45
+
46
+ // Remove the shared module from original applications
47
+ for (const appName of shared.applications) {
48
+ const app = candidate_applications.find(a => a.name === appName);
49
+ app.modules = app.modules.filter(m => normalizeModuleName(m) !== shared.name);
50
+ app.dependencies = app.dependencies || [];
51
+ app.dependencies.push({ target: shared.name, type: "data-dependency" });
52
+ }
53
+ }
54
+ ```
55
+
56
+ Update `candidate_applications` in the project feature.json.
57
+
58
+ ## Question Template
59
+
60
+ ```
61
+ question: "{language == 'fr' ? 'Souhaitez-vous extraire les modules partagés en application(s) dédiée(s) ?' : 'Do you want to extract shared modules as dedicated application(s)?'}"
62
+ header: "Extraction"
63
+ options:
64
+ - label: "{language == 'fr' ? 'Oui, extraire' : 'Yes, extract'}"
65
+ description: "{language == 'fr' ? 'Créer {sharedModules.length} application(s) transversale(s) supplémentaire(s)' : 'Create {sharedModules.length} additional cross-cutting application(s)'}"
66
+ - label: "{language == 'fr' ? 'Non, garder en l\'état' : 'No, keep as-is'}"
67
+ description: "{language == 'fr' ? 'Chaque application garde sa propre version du module' : 'Each application keeps its own version of the module'}"
68
+ ```