@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.
- package/.documentation/apex.html +644 -644
- package/.documentation/css/styles.css +2320 -2320
- package/.documentation/init.html +1377 -1377
- package/.documentation/js/app.js +780 -780
- package/.documentation/prd-json-v2.0.0.md +396 -396
- package/.documentation/testing-ba-e2e.md +462 -462
- package/config/default-config.json +95 -95
- package/config/mcp-defaults.json +62 -62
- package/config/settings.json +53 -53
- package/config/settings.local.example.json +16 -16
- package/dist/index.js +6 -3
- package/dist/index.js.map +1 -1
- package/dist/mcp-entry.mjs +6 -4
- package/dist/mcp-entry.mjs.map +1 -1
- package/package.json +115 -115
- package/scripts/extract-api-endpoints.ts +325 -325
- package/scripts/extract-business-rules.ts +440 -440
- package/scripts/generate-doc-with-mock-ui.ts +804 -804
- package/scripts/health-check.sh +168 -168
- package/scripts/postinstall.js +18 -18
- package/templates/agents/action.md +37 -37
- package/templates/agents/ba-reader.md +378 -378
- package/templates/agents/ba-writer.md +861 -861
- package/templates/agents/code-reviewer.md +163 -163
- package/templates/agents/db-reader.md +149 -149
- package/templates/agents/docs-context-reader.md +143 -143
- package/templates/agents/docs-sync-checker.md +122 -122
- package/templates/agents/efcore/conflicts.md +95 -84
- package/templates/agents/efcore/db-deploy.md +85 -74
- package/templates/agents/efcore/db-reset.md +96 -85
- package/templates/agents/efcore/db-seed.md +72 -61
- package/templates/agents/efcore/db-status.md +97 -86
- package/templates/agents/efcore/migration.md +197 -186
- package/templates/agents/efcore/rebase-snapshot.md +119 -108
- package/templates/agents/efcore/scan.md +103 -92
- package/templates/agents/efcore/squash.md +172 -161
- package/templates/agents/explore-codebase.md +66 -66
- package/templates/agents/explore-docs.md +98 -98
- package/templates/agents/fix-grammar.md +50 -50
- package/templates/agents/gitflow/abort.md +45 -45
- package/templates/agents/gitflow/cleanup.md +96 -96
- package/templates/agents/gitflow/commit.md +236 -236
- package/templates/agents/gitflow/exec.md +48 -48
- package/templates/agents/gitflow/finish.md +146 -146
- package/templates/agents/gitflow/init-clone.md +199 -199
- package/templates/agents/gitflow/init-detect.md +137 -137
- package/templates/agents/gitflow/init-validate.md +225 -225
- package/templates/agents/gitflow/init.md +340 -340
- package/templates/agents/gitflow/merge.md +145 -145
- package/templates/agents/gitflow/plan.md +42 -42
- package/templates/agents/gitflow/pr.md +191 -191
- package/templates/agents/gitflow/review.md +49 -49
- package/templates/agents/gitflow/start.md +147 -147
- package/templates/agents/gitflow/status.md +95 -95
- package/templates/agents/mcp-healthcheck.md +163 -163
- package/templates/agents/snipper.md +37 -37
- package/templates/agents/websearch.md +46 -46
- package/templates/hooks/appsettings-guard.sh +76 -76
- package/templates/hooks/docs-drift-check.md +96 -96
- package/templates/hooks/ef-migration-check.md +139 -139
- package/templates/hooks/hooks.json +58 -58
- package/templates/hooks/mcp-check.md +64 -64
- package/templates/hooks/ralph-mcp-logger.sh +46 -46
- package/templates/hooks/ralph-session-end.sh +69 -69
- package/templates/hooks/stop-hook.sh +177 -177
- package/templates/hooks/wsl-dotnet-cleanup.sh +24 -24
- package/templates/mcp-scaffolding/component.tsx.hbs +318 -318
- package/templates/mcp-scaffolding/controller.cs.hbs +192 -192
- package/templates/mcp-scaffolding/entity-extension.cs.hbs +239 -239
- package/templates/mcp-scaffolding/frontend/api-client.ts.hbs +116 -116
- package/templates/mcp-scaffolding/frontend/nav-routes.ts.hbs +133 -133
- package/templates/mcp-scaffolding/frontend/routes.tsx.hbs +126 -126
- package/templates/mcp-scaffolding/migrations/seed-roles.cs.hbs +261 -261
- package/templates/mcp-scaffolding/service-extension.cs.hbs +53 -53
- package/templates/mcp-scaffolding/tests/controller.test.cs.hbs +436 -436
- package/templates/mcp-scaffolding/tests/entity.test.cs.hbs +239 -239
- package/templates/mcp-scaffolding/tests/repository.test.cs.hbs +441 -441
- package/templates/mcp-scaffolding/tests/security.test.cs.hbs +442 -442
- package/templates/mcp-scaffolding/tests/service.test.cs.hbs +402 -402
- package/templates/mcp-scaffolding/tests/validator.test.cs.hbs +428 -428
- package/templates/project/DependencyInjection.Application.cs.template +25 -25
- package/templates/project/DependencyInjection.Infrastructure.cs.template +61 -61
- package/templates/project/DesignTimeExtensionsDbContextFactory.cs.template +70 -70
- package/templates/project/ExampleEntity.cs.template +116 -116
- package/templates/project/ExampleEntityConfiguration.cs.template +64 -64
- package/templates/project/ExampleService.cs.template +146 -146
- package/templates/project/ExtensionsDbContext.cs.template +41 -41
- package/templates/project/IExtensionsDbContext.cs.template +22 -22
- package/templates/project/Program.cs.template +47 -47
- package/templates/project/README.md +79 -79
- package/templates/project/api.ts.template +12 -12
- package/templates/project/appsettings.json.template +170 -170
- package/templates/project/claude-settings.json.template +5 -5
- package/templates/project/test-frontend/msw/handlers.ts +58 -58
- package/templates/project/test-frontend/msw/server.ts +25 -25
- package/templates/project/test-frontend/setup.ts +16 -16
- package/templates/project/test-frontend/test-utils.tsx +59 -59
- package/templates/project/test-frontend/vitest.config.ts +31 -31
- package/templates/ralph/README.md +93 -93
- package/templates/ralph/ralph.config.yaml +113 -113
- package/templates/scripts/setup-ralph-loop.sh +173 -173
- package/templates/skills/_resources/config-safety.md +61 -61
- package/templates/skills/_resources/context-digest-template.md +53 -53
- package/templates/skills/_resources/doc-context-cache.md +60 -60
- package/templates/skills/_resources/docs-manifest-schema.md +155 -155
- package/templates/skills/_resources/formatting-guide.md +124 -124
- package/templates/skills/_resources/mcp-validate-documentation-spec.md +181 -181
- package/templates/skills/_shared.md +228 -228
- package/templates/skills/admin/SKILL.md +48 -48
- package/templates/skills/ai-prompt/SKILL.md +107 -107
- package/templates/skills/ai-prompt/steps/step-00-init.md +47 -47
- package/templates/skills/ai-prompt/steps/step-01-implementation.md +122 -122
- package/templates/skills/apex/SKILL.md +168 -168
- package/templates/skills/apex/_shared.md +141 -141
- package/templates/skills/apex/references/agent-teams-protocol.md +164 -164
- package/templates/skills/apex/references/analysis-methods.md +141 -141
- package/templates/skills/apex/references/challenge-questions.md +145 -145
- package/templates/skills/apex/references/code-generation.md +412 -412
- package/templates/skills/apex/references/core-seed-data.md +1437 -1437
- package/templates/skills/apex/references/error-classification.md +144 -144
- package/templates/skills/apex/references/examine-build-validation.md +82 -82
- package/templates/skills/apex/references/execution-frontend-gates.md +177 -177
- package/templates/skills/apex/references/execution-frontend-patterns.md +105 -105
- package/templates/skills/apex/references/execution-layer1-rules.md +96 -96
- package/templates/skills/apex/references/initialization-challenge-flow.md +110 -110
- package/templates/skills/apex/references/planning-layer-mapping.md +151 -151
- package/templates/skills/apex/references/post-checks.md +1584 -1584
- package/templates/skills/apex/references/smartstack-api.md +1053 -1053
- package/templates/skills/apex/references/smartstack-frontend.md +1571 -1571
- package/templates/skills/apex/references/smartstack-layers.md +402 -402
- package/templates/skills/apex/steps/step-00-init.md +307 -307
- package/templates/skills/apex/steps/step-01-analyze.md +165 -165
- package/templates/skills/apex/steps/step-02-plan.md +144 -144
- package/templates/skills/apex/steps/step-03-execute.md +328 -328
- package/templates/skills/apex/steps/step-04-examine.md +263 -263
- package/templates/skills/apex/steps/step-05-deep-review.md +129 -129
- package/templates/skills/apex/steps/step-06-resolve.md +101 -101
- package/templates/skills/apex/steps/step-07-tests.md +238 -238
- package/templates/skills/apex/steps/step-08-run-tests.md +125 -125
- package/templates/skills/application/SKILL.md +4 -4
- package/templates/skills/application/references/application-roles-template.md +227 -227
- package/templates/skills/application/references/backend-controller-hierarchy.md +58 -58
- package/templates/skills/application/references/backend-entity-seeding.md +72 -72
- package/templates/skills/application/references/backend-seeding-and-dto-output.md +83 -83
- package/templates/skills/application/references/backend-table-prefix-mapping.md +79 -79
- package/templates/skills/application/references/backend-verification.md +88 -88
- package/templates/skills/application/references/frontend-i18n-and-output.md +67 -67
- package/templates/skills/application/references/frontend-route-naming.md +117 -117
- package/templates/skills/application/references/frontend-route-wiring-app-tsx.md +107 -107
- package/templates/skills/application/references/frontend-verification.md +156 -156
- package/templates/skills/application/references/migration-checklist-troubleshooting.md +1 -1
- package/templates/skills/application/references/provider-template.md +177 -177
- package/templates/skills/application/references/roles-client-project-handling.md +55 -55
- package/templates/skills/application/references/roles-fallback-procedure.md +149 -149
- package/templates/skills/application/references/test-coverage-requirements.md +213 -213
- package/templates/skills/application/references/test-frontend.md +73 -73
- package/templates/skills/application/references/test-prerequisites.md +72 -72
- package/templates/skills/application/steps/step-05-frontend.md +176 -176
- package/templates/skills/application/steps/step-06-migration.md +193 -193
- package/templates/skills/application/steps/step-07-tests.md +356 -356
- package/templates/skills/application/steps/step-08-documentation.md +137 -137
- package/templates/skills/application/templates-backend.md +463 -463
- package/templates/skills/application/templates-frontend.md +685 -685
- package/templates/skills/application/templates-i18n.md +520 -520
- package/templates/skills/application/templates-seed.md +1096 -1096
- package/templates/skills/business-analyse/SKILL.md +327 -327
- package/templates/skills/business-analyse/_architecture.md +123 -123
- package/templates/skills/business-analyse/_elicitation.md +206 -206
- package/templates/skills/business-analyse/_module-loop.md +115 -115
- package/templates/skills/business-analyse/_shared.md +383 -383
- package/templates/skills/business-analyse/_suggestions.md +34 -34
- package/templates/skills/business-analyse/html/ba-interactive.html +4477 -4477
- package/templates/skills/business-analyse/html/build-html.js +77 -77
- package/templates/skills/business-analyse/html/src/scripts/01-data-init.js +150 -150
- package/templates/skills/business-analyse/html/src/scripts/02-navigation.js +227 -227
- package/templates/skills/business-analyse/html/src/scripts/03-render-cadrage.js +199 -199
- package/templates/skills/business-analyse/html/src/scripts/04-render-modules.js +205 -205
- package/templates/skills/business-analyse/html/src/scripts/05-render-specs.js +647 -647
- package/templates/skills/business-analyse/html/src/scripts/06-render-consolidation.js +195 -195
- package/templates/skills/business-analyse/html/src/scripts/07-render-handoff.js +92 -92
- package/templates/skills/business-analyse/html/src/scripts/08-editing.js +135 -135
- package/templates/skills/business-analyse/html/src/scripts/09-export.js +168 -168
- package/templates/skills/business-analyse/html/src/scripts/10-comments.js +171 -171
- package/templates/skills/business-analyse/html/src/scripts/11-review-panel.js +166 -166
- package/templates/skills/business-analyse/html/src/styles/01-variables.css +38 -38
- package/templates/skills/business-analyse/html/src/styles/02-layout.css +101 -101
- package/templates/skills/business-analyse/html/src/styles/03-navigation.css +120 -120
- package/templates/skills/business-analyse/html/src/styles/04-cards.css +196 -196
- package/templates/skills/business-analyse/html/src/styles/05-modules.css +454 -454
- package/templates/skills/business-analyse/html/src/styles/06-wireframes.css +272 -272
- package/templates/skills/business-analyse/html/src/styles/07-comments.css +184 -184
- package/templates/skills/business-analyse/html/src/styles/08-review-panel.css +241 -241
- package/templates/skills/business-analyse/html/src/template.html +516 -516
- package/templates/skills/business-analyse/patterns/suggestion-catalog.md +546 -546
- package/templates/skills/business-analyse/questionnaire/00-application.md +160 -160
- package/templates/skills/business-analyse/questionnaire/00b-project.md +85 -85
- package/templates/skills/business-analyse/questionnaire/01-context.md +185 -185
- package/templates/skills/business-analyse/questionnaire/02-stakeholders.md +189 -189
- package/templates/skills/business-analyse/questionnaire/03-scope.md +164 -164
- package/templates/skills/business-analyse/questionnaire/04-data.md +88 -88
- package/templates/skills/business-analyse/questionnaire/05-integrations.md +58 -58
- package/templates/skills/business-analyse/questionnaire/06-security.md +68 -68
- package/templates/skills/business-analyse/questionnaire/07-ui.md +76 -76
- package/templates/skills/business-analyse/questionnaire/08-performance.md +42 -42
- package/templates/skills/business-analyse/questionnaire/09-constraints.md +45 -45
- package/templates/skills/business-analyse/questionnaire/10-documentation.md +43 -43
- package/templates/skills/business-analyse/questionnaire/11-data-lifecycle.md +59 -59
- package/templates/skills/business-analyse/questionnaire/12-migration.md +58 -58
- package/templates/skills/business-analyse/questionnaire/13-cross-module.md +69 -69
- package/templates/skills/business-analyse/questionnaire/14-risk-assumptions.md +135 -135
- package/templates/skills/business-analyse/questionnaire/15-success-metrics.md +136 -136
- package/templates/skills/business-analyse/questionnaire.md +337 -337
- package/templates/skills/business-analyse/react/application-viewer.md +242 -242
- package/templates/skills/business-analyse/react/components.md +551 -551
- package/templates/skills/business-analyse/react/i18n-template.md +306 -306
- package/templates/skills/business-analyse/references/acceptance-criteria.md +169 -169
- package/templates/skills/business-analyse/references/agent-module-prompt.md +362 -362
- package/templates/skills/business-analyse/references/agent-pooling-best-practices.md +557 -557
- package/templates/skills/business-analyse/references/analysis-semantic-checks.md +190 -190
- package/templates/skills/business-analyse/references/cache-warming-strategy.md +566 -566
- package/templates/skills/business-analyse/references/cadrage-challenge-patterns.md +41 -41
- package/templates/skills/business-analyse/references/cadrage-coverage-matrix.md +74 -74
- package/templates/skills/business-analyse/references/cadrage-pre-analysis.md +115 -115
- package/templates/skills/business-analyse/references/cadrage-shared-modules.md +68 -69
- package/templates/skills/business-analyse/references/cadrage-structure-cards.md +85 -85
- package/templates/skills/business-analyse/references/compilation-structure-cards.md +297 -297
- package/templates/skills/business-analyse/references/consolidation-structural-checks.md +107 -107
- package/templates/skills/business-analyse/references/deploy-data-build.md +180 -180
- package/templates/skills/business-analyse/references/deploy-modes.md +118 -118
- package/templates/skills/business-analyse/references/detection-strategies.md +424 -424
- package/templates/skills/business-analyse/references/entity-architecture-decision.md +218 -218
- package/templates/skills/business-analyse/references/handoff-file-templates.md +120 -120
- package/templates/skills/business-analyse/references/handoff-mappings.md +81 -81
- package/templates/skills/business-analyse/references/handoff-seeddata-generation.md +312 -312
- package/templates/skills/business-analyse/references/html-data-mapping.md +299 -299
- package/templates/skills/business-analyse/references/init-schema-deployment.md +65 -65
- package/templates/skills/business-analyse/references/naming-conventions.md +243 -243
- package/templates/skills/business-analyse/references/prd-generation.md +258 -258
- package/templates/skills/business-analyse/references/review-data-mapping.md +363 -363
- package/templates/skills/business-analyse/references/robustness-checks.md +542 -542
- package/templates/skills/business-analyse/references/spec-auto-inference.md +111 -111
- package/templates/skills/business-analyse/references/team-orchestration.md +1022 -1022
- package/templates/skills/business-analyse/references/ui-dashboard-spec.md +85 -85
- package/templates/skills/business-analyse/references/ui-resource-cards.md +259 -259
- package/templates/skills/business-analyse/references/validate-incremental-html.md +121 -121
- package/templates/skills/business-analyse/references/validation-checklist.md +347 -347
- package/templates/skills/business-analyse/references/wireframe-svg-style-guide.md +335 -335
- package/templates/skills/business-analyse/schemas/application-schema.json +453 -453
- package/templates/skills/business-analyse/schemas/feature-schema.json +53 -53
- package/templates/skills/business-analyse/schemas/project-schema.json +485 -485
- package/templates/skills/business-analyse/schemas/sections/analysis-schema.json +201 -201
- package/templates/skills/business-analyse/schemas/sections/discovery-schema.json +82 -82
- package/templates/skills/business-analyse/schemas/sections/handoff-schema.json +80 -80
- package/templates/skills/business-analyse/schemas/sections/metadata-schema.json +70 -70
- package/templates/skills/business-analyse/schemas/sections/specification-schema.json +547 -547
- package/templates/skills/business-analyse/schemas/sections/validation-schema.json +93 -93
- package/templates/skills/business-analyse/schemas/shared/common-defs.json +226 -226
- package/templates/skills/business-analyse/steps/step-00-init.md +575 -576
- package/templates/skills/business-analyse/steps/step-01-cadrage.md +767 -767
- package/templates/skills/business-analyse/steps/step-01b-applications.md +419 -419
- package/templates/skills/business-analyse/steps/step-02-decomposition.md +387 -387
- package/templates/skills/business-analyse/steps/step-03a-data.md +16 -16
- package/templates/skills/business-analyse/steps/step-03a1-setup.md +506 -506
- package/templates/skills/business-analyse/steps/step-03a2-analysis.md +252 -252
- package/templates/skills/business-analyse/steps/step-03b-ui.md +425 -425
- package/templates/skills/business-analyse/steps/step-03c-compile.md +611 -611
- package/templates/skills/business-analyse/steps/step-03d-validate.md +783 -783
- package/templates/skills/business-analyse/steps/step-04-consolidation.md +17 -17
- package/templates/skills/business-analyse/steps/step-04a-collect.md +415 -415
- package/templates/skills/business-analyse/steps/step-04b-analyze.md +163 -163
- package/templates/skills/business-analyse/steps/step-04c-decide.md +186 -186
- package/templates/skills/business-analyse/steps/step-05a-handoff.md +840 -840
- package/templates/skills/business-analyse/steps/step-05b-deploy.md +522 -522
- package/templates/skills/business-analyse/steps/step-05c-ralph-readiness.md +703 -703
- package/templates/skills/business-analyse/steps/step-06-review.md +278 -278
- package/templates/skills/business-analyse/templates/tpl-frd.md +168 -168
- package/templates/skills/business-analyse/templates/tpl-handoff.md +186 -186
- package/templates/skills/business-analyse/templates/tpl-launch-displays.md +59 -59
- package/templates/skills/business-analyse/templates/tpl-progress.md +172 -172
- package/templates/skills/business-analyse/templates-frd.md +476 -476
- package/templates/skills/business-analyse/templates-react.md +574 -574
- package/templates/skills/cc-agent/SKILL.md +129 -129
- package/templates/skills/cc-agent/references/agent-behavior-patterns.md +95 -95
- package/templates/skills/cc-agent/references/agent-frontmatter.md +213 -213
- package/templates/skills/cc-agent/references/permission-modes.md +102 -102
- package/templates/skills/cc-agent/references/tools-reference.md +144 -144
- package/templates/skills/cc-agent/steps/step-00-init.md +134 -134
- package/templates/skills/cc-agent/steps/step-01-design.md +186 -186
- package/templates/skills/cc-agent/steps/step-02-generate.md +131 -131
- package/templates/skills/cc-agent/steps/step-03-validate.md +130 -130
- package/templates/skills/cc-agent/templates/agent-categorized.md +67 -67
- package/templates/skills/cc-agent/templates/agent-standalone.md +56 -56
- package/templates/skills/cc-agent/templates/agent-with-skills.md +94 -94
- package/templates/skills/cc-audit/SKILL.md +108 -108
- package/templates/skills/cc-audit/references/agent-checklist.md +91 -91
- package/templates/skills/cc-audit/references/hook-checklist.md +110 -110
- package/templates/skills/cc-audit/references/skill-checklist.md +70 -70
- package/templates/skills/cc-audit/steps/step-00-init.md +98 -98
- package/templates/skills/cc-audit/steps/step-01-scan.md +142 -142
- package/templates/skills/cc-audit/steps/step-02-analyze.md +158 -158
- package/templates/skills/cc-audit/steps/step-03-report.md +142 -142
- package/templates/skills/cc-skill/SKILL.md +134 -134
- package/templates/skills/cc-skill/references/best-practices.md +167 -167
- package/templates/skills/cc-skill/references/frontmatter-reference.md +182 -182
- package/templates/skills/cc-skill/references/skill-patterns.md +199 -199
- package/templates/skills/cc-skill/steps/step-00-init.md +119 -119
- package/templates/skills/cc-skill/steps/step-01-design.md +199 -199
- package/templates/skills/cc-skill/steps/step-02-generate.md +145 -145
- package/templates/skills/cc-skill/steps/step-03-steps.md +151 -151
- package/templates/skills/cc-skill/steps/step-04-validate.md +124 -124
- package/templates/skills/cc-skill/templates/skill-forked.md +85 -85
- package/templates/skills/cc-skill/templates/skill-progressive.md +102 -102
- package/templates/skills/cc-skill/templates/skill-simple.md +75 -75
- package/templates/skills/cc-skill/templates/step-template.md +82 -82
- package/templates/skills/check-version/SKILL.md +196 -196
- package/templates/skills/controller/SKILL.md +162 -162
- package/templates/skills/controller/postman-templates.md +614 -614
- package/templates/skills/controller/references/controller-code-templates.md +159 -159
- package/templates/skills/controller/references/mcp-scaffold-workflow.md +209 -209
- package/templates/skills/controller/references/permission-sync-templates.md +149 -149
- package/templates/skills/controller/steps/step-00-init.md +193 -191
- package/templates/skills/controller/steps/step-01-analyze.md +146 -146
- package/templates/skills/controller/steps/step-02-plan.md +176 -176
- package/templates/skills/controller/steps/step-03-generate.md +189 -189
- package/templates/skills/controller/steps/step-04-perms.md +80 -80
- package/templates/skills/controller/steps/step-05-validate.md +107 -107
- package/templates/skills/controller/templates.md +1555 -1555
- package/templates/skills/debug/SKILL.md +70 -70
- package/templates/skills/debug/references/team-protocol.md +232 -232
- package/templates/skills/debug/steps/step-00-init.md +57 -57
- package/templates/skills/debug/steps/step-01-analyze.md +219 -219
- package/templates/skills/debug/steps/step-02-resolve.md +85 -85
- package/templates/skills/documentation/SKILL.md +132 -132
- package/templates/skills/documentation/data-schema.md +227 -227
- package/templates/skills/documentation/steps/step-00-init.md +70 -70
- package/templates/skills/documentation/steps/step-01-scan.md +113 -113
- package/templates/skills/documentation/steps/step-02-generate.md +231 -231
- package/templates/skills/documentation/steps/step-03-validate.md +251 -238
- package/templates/skills/documentation/templates.md +662 -663
- package/templates/skills/efcore/SKILL.md +168 -167
- package/templates/skills/efcore/references/both-contexts.md +32 -32
- package/templates/skills/efcore/references/database-operations.md +67 -67
- package/templates/skills/efcore/references/destructive-operations.md +38 -38
- package/templates/skills/efcore/references/reset-operations.md +81 -81
- package/templates/skills/efcore/references/seed-methods.md +86 -86
- package/templates/skills/efcore/references/shared-init-functions.md +250 -250
- package/templates/skills/efcore/references/sql-objects-injection.md +61 -61
- package/templates/skills/efcore/references/troubleshooting.md +81 -81
- package/templates/skills/efcore/references/zero-downtime-patterns.md +227 -227
- package/templates/skills/efcore/steps/db/step-deploy.md +217 -217
- package/templates/skills/efcore/steps/db/step-reset.md +186 -186
- package/templates/skills/efcore/steps/db/step-seed.md +166 -166
- package/templates/skills/efcore/steps/db/step-status.md +173 -173
- package/templates/skills/efcore/steps/migration/step-00-init.md +102 -102
- package/templates/skills/efcore/steps/migration/step-01-check.md +164 -164
- package/templates/skills/efcore/steps/migration/step-02-create.md +160 -160
- package/templates/skills/efcore/steps/migration/step-03-validate.md +168 -168
- package/templates/skills/efcore/steps/rebase-snapshot/step-00-init.md +173 -173
- package/templates/skills/efcore/steps/rebase-snapshot/step-01-backup.md +100 -100
- package/templates/skills/efcore/steps/rebase-snapshot/step-02-fetch.md +115 -115
- package/templates/skills/efcore/steps/rebase-snapshot/step-03-create.md +112 -112
- package/templates/skills/efcore/steps/rebase-snapshot/step-04-validate.md +157 -157
- package/templates/skills/efcore/steps/shared/step-00-init.md +131 -131
- package/templates/skills/efcore/steps/squash/step-00-init.md +141 -141
- package/templates/skills/efcore/steps/squash/step-01-backup.md +120 -120
- package/templates/skills/efcore/steps/squash/step-02-fetch.md +168 -168
- package/templates/skills/efcore/steps/squash/step-03-create.md +184 -184
- package/templates/skills/efcore/steps/squash/step-04-validate.md +174 -174
- package/templates/skills/explore/SKILL.md +98 -98
- package/templates/skills/feature-full/SKILL.md +111 -111
- package/templates/skills/feature-full/steps/step-00-init.md +57 -57
- package/templates/skills/feature-full/steps/step-01-implementation.md +120 -120
- package/templates/skills/gitflow/SKILL.md +377 -377
- package/templates/skills/gitflow/_shared.md +620 -620
- package/templates/skills/gitflow/phases/abort.md +189 -189
- package/templates/skills/gitflow/phases/cleanup.md +234 -234
- package/templates/skills/gitflow/phases/status.md +192 -192
- package/templates/skills/gitflow/references/commit-message-generation.md +58 -58
- package/templates/skills/gitflow/references/commit-migration-validation.md +49 -49
- package/templates/skills/gitflow/references/finish-cleanup.md +55 -55
- package/templates/skills/gitflow/references/finish-version-bumping.md +45 -45
- package/templates/skills/gitflow/references/init-config-template.md +135 -135
- package/templates/skills/gitflow/references/init-environment-detection.md +41 -41
- package/templates/skills/gitflow/references/init-name-normalization.md +103 -103
- package/templates/skills/gitflow/references/init-questions.md +185 -185
- package/templates/skills/gitflow/references/init-structure-creation.md +75 -75
- package/templates/skills/gitflow/references/init-version-detection.md +21 -21
- package/templates/skills/gitflow/references/init-workspace-detection.md +43 -43
- package/templates/skills/gitflow/references/merge-ci-status.md +36 -36
- package/templates/skills/gitflow/references/merge-execution.md +62 -62
- package/templates/skills/gitflow/references/merge-pr-context.md +76 -76
- package/templates/skills/gitflow/references/plan-template.md +69 -69
- package/templates/skills/gitflow/references/pr-build-checks.md +60 -60
- package/templates/skills/gitflow/references/pr-generation.md +58 -58
- package/templates/skills/gitflow/references/start-branch-normalization.md +28 -28
- package/templates/skills/gitflow/references/start-efcore-preflight.md +70 -70
- package/templates/skills/gitflow/references/start-local-config.md +113 -113
- package/templates/skills/gitflow/references/start-worktree-creation.md +50 -50
- package/templates/skills/gitflow/references/sync-push-verify.md +44 -44
- package/templates/skills/gitflow/references/sync-rebase-conflicts.md +38 -38
- package/templates/skills/gitflow/steps/step-commit.md +199 -199
- package/templates/skills/gitflow/steps/step-finish.md +147 -147
- package/templates/skills/gitflow/steps/step-init.md +190 -190
- package/templates/skills/gitflow/steps/step-merge.md +85 -85
- package/templates/skills/gitflow/steps/step-plan.md +151 -151
- package/templates/skills/gitflow/steps/step-pr.md +199 -199
- package/templates/skills/gitflow/steps/step-start.md +195 -195
- package/templates/skills/gitflow/steps/step-sync.md +161 -161
- package/templates/skills/gitflow/templates/config.json +72 -72
- package/templates/skills/mcp/SKILL.md +62 -62
- package/templates/skills/mcp/steps/step-01-healthcheck.md +108 -108
- package/templates/skills/mcp/steps/step-02-tools.md +73 -73
- package/templates/skills/notification/SKILL.md +173 -173
- package/templates/skills/quick-search/SKILL.md +99 -99
- package/templates/skills/ralph-loop/SKILL.md +234 -234
- package/templates/skills/ralph-loop/references/category-completeness.md +185 -185
- package/templates/skills/ralph-loop/references/category-rules.md +96 -96
- package/templates/skills/ralph-loop/references/compact-loop.md +300 -300
- package/templates/skills/ralph-loop/references/init-resume-recovery.md +127 -127
- package/templates/skills/ralph-loop/references/module-transition.md +151 -151
- package/templates/skills/ralph-loop/references/multi-module-queue.md +171 -171
- package/templates/skills/ralph-loop/references/parallel-execution.md +246 -246
- package/templates/skills/ralph-loop/references/section-splitting.md +439 -439
- package/templates/skills/ralph-loop/references/task-transform-legacy.md +256 -256
- package/templates/skills/ralph-loop/references/team-orchestration.md +547 -547
- package/templates/skills/ralph-loop/steps/step-00-init.md +150 -150
- package/templates/skills/ralph-loop/steps/step-01-task.md +174 -174
- package/templates/skills/ralph-loop/steps/step-02-execute.md +177 -177
- package/templates/skills/ralph-loop/steps/step-03-commit.md +92 -92
- package/templates/skills/ralph-loop/steps/step-04-check.md +207 -207
- package/templates/skills/ralph-loop/steps/step-05-report.md +175 -175
- package/templates/skills/refactor/SKILL.md +56 -56
- package/templates/skills/refactor/steps/step-01-discover.md +60 -60
- package/templates/skills/refactor/steps/step-02-execute.md +67 -67
- package/templates/skills/review-code/SKILL.md +95 -94
- package/templates/skills/review-code/references/clean-code-principles.md +292 -292
- package/templates/skills/review-code/references/code-quality-metrics.md +174 -174
- package/templates/skills/review-code/references/feedback-patterns.md +149 -149
- package/templates/skills/review-code/references/owasp-api-top10.md +243 -243
- package/templates/skills/review-code/references/security-checklist.md +212 -212
- package/templates/skills/review-code/steps/step-01-smartstack.md +96 -96
- package/templates/skills/review-code/steps/step-02-detailed-review.md +80 -80
- package/templates/skills/review-code/steps/step-03-react.md +44 -44
- package/templates/skills/ui-components/SKILL.md +137 -137
- package/templates/skills/ui-components/accessibility.md +170 -170
- package/templates/skills/ui-components/patterns/dashboard-chart.md +327 -327
- package/templates/skills/ui-components/patterns/data-table.md +39 -39
- package/templates/skills/ui-components/patterns/entity-card.md +77 -77
- package/templates/skills/ui-components/patterns/grid-layout.md +91 -91
- package/templates/skills/ui-components/patterns/kanban.md +43 -43
- package/templates/skills/ui-components/responsive-guidelines.md +278 -278
- package/templates/skills/ui-components/style-guide.md +113 -113
- package/templates/skills/utils/SKILL.md +44 -44
- package/templates/skills/utils/subcommands/test-web-config.md +152 -152
- package/templates/skills/utils/subcommands/test-web.md +123 -123
- package/templates/skills/validate/SKILL.md +181 -181
- package/templates/skills/validate-feature/SKILL.md +101 -101
- package/templates/skills/validate-feature/references/api-smoke-tests.md +140 -140
- package/templates/skills/validate-feature/references/db-validation-checks.md +180 -180
- package/templates/skills/validate-feature/steps/step-00-dependencies.md +121 -121
- package/templates/skills/validate-feature/steps/step-01-compile.md +39 -39
- package/templates/skills/validate-feature/steps/step-02-unit-tests.md +45 -45
- package/templates/skills/validate-feature/steps/step-03-integration-tests.md +53 -53
- package/templates/skills/validate-feature/steps/step-04-api-smoke.md +94 -94
- package/templates/skills/validate-feature/steps/step-05-db-validation.md +149 -149
- package/templates/skills/workflow/SKILL.md +127 -127
- package/templates/skills/workflow/steps/step-00-init.md +57 -57
- package/templates/skills/workflow/steps/step-01-implementation.md +84 -84
- package/templates/test-web/api-health.json +38 -38
- package/templates/test-web/minimal.json +19 -19
- package/templates/test-web/npm-package.json +46 -46
- package/templates/test-web/seo-check.json +54 -54
|
@@ -1,335 +1,335 @@
|
|
|
1
|
-
# Wireframe SVG Style Guide
|
|
2
|
-
|
|
3
|
-
> **Purpose:** Self-contained specification for generating professional SVG wireframes from ASCII art.
|
|
4
|
-
> This document is sent as the FULL prompt to a Sonnet Task agent alongside the ASCII wireframe.
|
|
5
|
-
> Referenced by: `validate-incremental-html.md` (Step 3-bis), `step-05b-deploy.md` (Section 7-bis)
|
|
6
|
-
|
|
7
|
-
## Agent Prompt Template
|
|
8
|
-
|
|
9
|
-
> **USAGE:** Read this section, replace `{placeholders}` with actual wireframe data, send as the complete prompt to a Task(sonnet) agent. The agent returns ONLY the SVG markup string.
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
You are a professional UI wireframe designer. Convert the following ASCII wireframe into a high-quality SVG wireframe that looks like a modern web application mockup.
|
|
14
|
-
|
|
15
|
-
### Input
|
|
16
|
-
|
|
17
|
-
**Screen name:** `{screenName}`
|
|
18
|
-
**Module:** `{moduleName}`
|
|
19
|
-
**Section type:** `{sectionType}` (list|detail|create|dashboard|approve)
|
|
20
|
-
**ASCII wireframe:**
|
|
21
|
-
```
|
|
22
|
-
{asciiContent}
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
**Element metadata (if available):**
|
|
26
|
-
```json
|
|
27
|
-
{elementsJson}
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
### Output Requirements
|
|
31
|
-
|
|
32
|
-
Return ONLY the SVG markup as a single `<svg>` element. No explanation, no markdown, no code fences.
|
|
33
|
-
The SVG must be self-contained (no external fonts, no external CSS, no `<image>` tags).
|
|
34
|
-
|
|
35
|
-
### Visual Design System
|
|
36
|
-
|
|
37
|
-
#### Viewport & Canvas
|
|
38
|
-
- `viewBox="0 0 960 {dynamicHeight}"` — width fixed at 960, height adapts to content
|
|
39
|
-
- Minimum height: 540 for list views, 720 for detail views, 480 for dashboards
|
|
40
|
-
- Background: `#1e293b` (dark card background matching the HTML theme)
|
|
41
|
-
- 24px padding on all sides
|
|
42
|
-
- Root element: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 {height}">`
|
|
43
|
-
|
|
44
|
-
#### Color Palette (MUST use these exact colors)
|
|
45
|
-
|
|
46
|
-
| Role | Color | Usage |
|
|
47
|
-
|------|-------|-------|
|
|
48
|
-
| Background | `#1e293b` | Main canvas, card backgrounds |
|
|
49
|
-
| Surface | `#0f172a` | Input fields, table cells, nested panels |
|
|
50
|
-
| Border | `#334155` | All borders, dividers, table lines |
|
|
51
|
-
| Border light | `#475569` | Hover states, active borders |
|
|
52
|
-
| Primary | `#6366f1` | Primary buttons, active tabs, selected items |
|
|
53
|
-
| Primary hover | `#4f46e5` | Button hover state accent |
|
|
54
|
-
| Primary light | `#818cf8` | Links, column headers, highlighted text |
|
|
55
|
-
| Accent | `#06b6d4` | Secondary actions, info badges |
|
|
56
|
-
| Text bright | `#e2e8f0` | Headings, table header text, important labels |
|
|
57
|
-
| Text | `#b8c4d1` | Body text, table cell content |
|
|
58
|
-
| Text muted | `#8a9bb0` | Placeholders, secondary labels, pagination |
|
|
59
|
-
| Success | `#22c55e` | Active/approved status badges |
|
|
60
|
-
| Success bg | `rgba(34,197,94,0.15)` | Status badge background |
|
|
61
|
-
| Warning | `#eab308` | Pending/draft status badges |
|
|
62
|
-
| Warning bg | `rgba(234,179,8,0.15)` | Status badge background |
|
|
63
|
-
| Error | `#ef4444` | Error states, delete buttons |
|
|
64
|
-
| Gray | `#94a3b8` | Inactive/draft status |
|
|
65
|
-
| Gray bg | `rgba(100,116,139,0.15)` | Status badge background |
|
|
66
|
-
| Row hover | `rgba(99,102,241,0.05)` | Table row hover |
|
|
67
|
-
| Shadow | `rgba(0,0,0,0.25)` | Drop shadow for cards |
|
|
68
|
-
|
|
69
|
-
#### Typography (embedded via system fonts)
|
|
70
|
-
|
|
71
|
-
- Font family: `'Inter', 'Segoe UI', system-ui, sans-serif` (use `font-family` attribute on EVERY `<text>`)
|
|
72
|
-
- Page title: 18px, font-weight 600, color `#e2e8f0`
|
|
73
|
-
- Section heading: 14px, font-weight 600, color `#e2e8f0`
|
|
74
|
-
- Table header: 11px, font-weight 600, text-transform uppercase, letter-spacing 0.05em, color `#8a9bb0`
|
|
75
|
-
- Body text / table cells: 13px, font-weight 400, color `#b8c4d1`
|
|
76
|
-
- Button text: 13px, font-weight 500, color `#ffffff`
|
|
77
|
-
- Small text / badges: 11px, font-weight 500
|
|
78
|
-
- Placeholder text: 13px, font-weight 400, color `#8a9bb0`, font-style italic
|
|
79
|
-
|
|
80
|
-
---
|
|
81
|
-
|
|
82
|
-
### Component Patterns
|
|
83
|
-
|
|
84
|
-
#### Buttons (Primary)
|
|
85
|
-
```xml
|
|
86
|
-
<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="#6366f1"/>
|
|
87
|
-
<text x="{x+w/2}" y="{y+22}" text-anchor="middle"
|
|
88
|
-
font-family="Inter,Segoe UI,system-ui,sans-serif" font-size="13"
|
|
89
|
-
font-weight="500" fill="#ffffff">{label}</text>
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
#### Buttons (Secondary/Ghost)
|
|
93
|
-
```xml
|
|
94
|
-
<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="none" stroke="#334155" stroke-width="1"/>
|
|
95
|
-
<text x="{x+w/2}" y="{y+22}" text-anchor="middle"
|
|
96
|
-
font-family="Inter,Segoe UI,system-ui,sans-serif" font-size="13"
|
|
97
|
-
font-weight="500" fill="#b8c4d1">{label}</text>
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
#### Input Fields
|
|
101
|
-
```xml
|
|
102
|
-
<rect x="{x}" y="{y}" width="{w}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
|
|
103
|
-
<text x="{x+12}" y="{y+25}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
104
|
-
font-size="13" fill="#8a9bb0" font-style="italic">{placeholder}</text>
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
#### Search Bar (input with magnifying glass icon)
|
|
108
|
-
```xml
|
|
109
|
-
<rect x="{x}" y="{y}" width="{w}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
|
|
110
|
-
<circle cx="{x+22}" cy="{y+18}" r="7" fill="none" stroke="#8a9bb0" stroke-width="1.5"/>
|
|
111
|
-
<line x1="{x+27}" y1="{y+23}" x2="{x+31}" y2="{y+27}" stroke="#8a9bb0" stroke-width="1.5" stroke-linecap="round"/>
|
|
112
|
-
<text x="{x+40}" y="{y+25}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
113
|
-
font-size="13" fill="#8a9bb0" font-style="italic">Rechercher...</text>
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
#### Dropdown / Select
|
|
117
|
-
```xml
|
|
118
|
-
<rect x="{x}" y="{y}" width="{w}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
|
|
119
|
-
<text x="{x+12}" y="{y+25}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
120
|
-
font-size="13" fill="#b8c4d1">{selectedValue}</text>
|
|
121
|
-
<path d="M{x+w-24},{y+16} l6,8 l6,-8" fill="#8a9bb0"/>
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
#### Data Table
|
|
125
|
-
- Header row: background `#0f172a`, text uppercase 11px, color `#8a9bb0`, letter-spacing 0.05em
|
|
126
|
-
- Data rows: alternating `#1e293b` and `rgba(15,23,42,0.5)`, height 44px
|
|
127
|
-
- Row hover: one sample row with `rgba(99,102,241,0.05)` fill
|
|
128
|
-
- Column dividers: `stroke="#334155"` at 0.5 opacity
|
|
129
|
-
- Cell padding: 16px horizontal
|
|
130
|
-
- Header height: 40px
|
|
131
|
-
- Action column (rightmost): 3-dot vertical ellipsis menu icon
|
|
132
|
-
|
|
133
|
-
#### Status Badges
|
|
134
|
-
```xml
|
|
135
|
-
<!-- Active/Approved (green) -->
|
|
136
|
-
<rect x="{x}" y="{y}" width="{w}" height="22" rx="11" fill="rgba(34,197,94,0.15)"/>
|
|
137
|
-
<circle cx="{x+10}" cy="{y+11}" r="3" fill="#4ade80"/>
|
|
138
|
-
<text x="{x+18}" y="{y+15}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
139
|
-
font-size="11" font-weight="500" fill="#4ade80">{label}</text>
|
|
140
|
-
|
|
141
|
-
<!-- Pending/Warning (yellow) -->
|
|
142
|
-
<rect x="{x}" y="{y}" width="{w}" height="22" rx="11" fill="rgba(234,179,8,0.15)"/>
|
|
143
|
-
<circle cx="{x+10}" cy="{y+11}" r="3" fill="#facc15"/>
|
|
144
|
-
<text x="{x+18}" y="{y+15}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
145
|
-
font-size="11" font-weight="500" fill="#facc15">{label}</text>
|
|
146
|
-
|
|
147
|
-
<!-- Inactive/Draft (gray) -->
|
|
148
|
-
<rect x="{x}" y="{y}" width="{w}" height="22" rx="11" fill="rgba(100,116,139,0.15)"/>
|
|
149
|
-
<circle cx="{x+10}" cy="{y+11}" r="3" fill="#94a3b8"/>
|
|
150
|
-
<text x="{x+18}" y="{y+15}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
151
|
-
font-size="11" font-weight="500" fill="#94a3b8">{label}</text>
|
|
152
|
-
```
|
|
153
|
-
|
|
154
|
-
#### Cards / Panels
|
|
155
|
-
```xml
|
|
156
|
-
<defs>
|
|
157
|
-
<filter id="shadow" x="-2%" y="-2%" width="104%" height="104%">
|
|
158
|
-
<feDropShadow dx="0" dy="2" stdDeviation="4" flood-color="#000000" flood-opacity="0.25"/>
|
|
159
|
-
</filter>
|
|
160
|
-
</defs>
|
|
161
|
-
<rect x="{x}" y="{y}" width="{w}" height="{h}" rx="12" fill="#1e293b" stroke="#334155" stroke-width="1" filter="url(#shadow)"/>
|
|
162
|
-
```
|
|
163
|
-
|
|
164
|
-
#### Tabs
|
|
165
|
-
```xml
|
|
166
|
-
<!-- Active tab -->
|
|
167
|
-
<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="#6366f1"/>
|
|
168
|
-
<text x="{x+w/2}" y="{y+22}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
169
|
-
font-size="13" font-weight="500" fill="#ffffff">{label}</text>
|
|
170
|
-
|
|
171
|
-
<!-- Inactive tab -->
|
|
172
|
-
<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="transparent"/>
|
|
173
|
-
<text x="{x+w/2}" y="{y+22}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
174
|
-
font-size="13" font-weight="400" fill="#8a9bb0">{label}</text>
|
|
175
|
-
```
|
|
176
|
-
|
|
177
|
-
#### Pagination
|
|
178
|
-
```xml
|
|
179
|
-
<text x="{x}" y="{y}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
180
|
-
font-size="12" fill="#8a9bb0">1-25 de 142</text>
|
|
181
|
-
<!-- Active page -->
|
|
182
|
-
<rect x="{px}" y="{py}" width="28" height="28" rx="6" fill="#6366f1"/>
|
|
183
|
-
<text x="{px+14}" y="{py+18}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
184
|
-
font-size="12" font-weight="500" fill="#fff">1</text>
|
|
185
|
-
<!-- Inactive page -->
|
|
186
|
-
<rect x="{px+32}" y="{py}" width="28" height="28" rx="6" fill="none" stroke="#334155"/>
|
|
187
|
-
<text x="{px+46}" y="{py+18}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
188
|
-
font-size="12" fill="#8a9bb0">2</text>
|
|
189
|
-
```
|
|
190
|
-
|
|
191
|
-
#### KPI Cards (Dashboard)
|
|
192
|
-
```xml
|
|
193
|
-
<rect x="{x}" y="{y}" width="{w}" height="80" rx="8" fill="#334155"/>
|
|
194
|
-
<text x="{x+w/2}" y="{y+35}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
195
|
-
font-size="22" font-weight="700" fill="#e2e8f0">{value}</text>
|
|
196
|
-
<text x="{x+w/2}" y="{y+55}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
197
|
-
font-size="11" fill="#8a9bb0">{label}</text>
|
|
198
|
-
```
|
|
199
|
-
|
|
200
|
-
#### Chart Placeholder (Dashboard)
|
|
201
|
-
```xml
|
|
202
|
-
<rect x="{x}" y="{y}" width="{w}" height="180" rx="8" fill="none"
|
|
203
|
-
stroke="#334155" stroke-dasharray="6,4"/>
|
|
204
|
-
<text x="{x+w/2}" y="{y+90}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
205
|
-
font-size="13" fill="#8a9bb0">{chartLabel}</text>
|
|
206
|
-
```
|
|
207
|
-
|
|
208
|
-
#### Back Button / Navigation
|
|
209
|
-
```xml
|
|
210
|
-
<path d="M{x},{y+10} l-8,-10 l8,-10" fill="none" stroke="#818cf8" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
|
|
211
|
-
<text x="{x+8}" y="{y+5}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
212
|
-
font-size="13" font-weight="500" fill="#818cf8">Retour a la liste</text>
|
|
213
|
-
```
|
|
214
|
-
|
|
215
|
-
#### Form Layout (2-column)
|
|
216
|
-
```xml
|
|
217
|
-
<!-- Label -->
|
|
218
|
-
<text x="{x}" y="{y}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
219
|
-
font-size="12" font-weight="500" fill="#8a9bb0">{fieldLabel}</text>
|
|
220
|
-
<!-- Input below label (12px gap) -->
|
|
221
|
-
<rect x="{x}" y="{y+8}" width="{colWidth}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
|
|
222
|
-
<text x="{x+12}" y="{y+33}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
223
|
-
font-size="13" fill="#b8c4d1">{value or placeholder}</text>
|
|
224
|
-
```
|
|
225
|
-
|
|
226
|
-
---
|
|
227
|
-
|
|
228
|
-
### Section-Specific Layout Rules
|
|
229
|
-
|
|
230
|
-
**List Page Layout:**
|
|
231
|
-
1. Page header (title left + primary action button right) at y=24
|
|
232
|
-
2. Filter bar below header (search + dropdowns) at y=72
|
|
233
|
-
3. Data table occupying remaining space at y=128
|
|
234
|
-
4. Pagination bar at bottom
|
|
235
|
-
|
|
236
|
-
**Detail Page Layout:**
|
|
237
|
-
1. Back button + breadcrumb at y=24
|
|
238
|
-
2. Entity header (code + name + status badge + action buttons) at y=60
|
|
239
|
-
3. Horizontal divider at y=100
|
|
240
|
-
4. Tab bar at y=112
|
|
241
|
-
5. Active tab content area at y=160
|
|
242
|
-
|
|
243
|
-
**Create/Edit Form Layout:**
|
|
244
|
-
1. Form title at y=24
|
|
245
|
-
2. Two-column grid of form fields (label above input) starting at y=64
|
|
246
|
-
3. Horizontal divider before actions
|
|
247
|
-
4. Cancel + Submit buttons right-aligned at bottom
|
|
248
|
-
|
|
249
|
-
**Dashboard Layout:**
|
|
250
|
-
1. KPI cards in a 4-column grid at y=24
|
|
251
|
-
2. 2-column grid of chart placeholders at y=128
|
|
252
|
-
3. Optional filter bar above KPIs
|
|
253
|
-
|
|
254
|
-
---
|
|
255
|
-
|
|
256
|
-
### Quality Rules (MANDATORY)
|
|
257
|
-
|
|
258
|
-
1. **Every `<text>` element** MUST have the `font-family` attribute set
|
|
259
|
-
2. **No external dependencies** — no `<use>`, no `<image>`, no `xlink:href`
|
|
260
|
-
3. **All text must be readable** — contrast ratio >=4.5:1 on its background
|
|
261
|
-
4. **Consistent spacing** — 24px margin, 16px padding, 12px gap between form fields
|
|
262
|
-
5. **Rounded corners everywhere** — `rx="6"` minimum for interactive elements, `rx="12"` for cards
|
|
263
|
-
6. **No `<style>` blocks** — all styling via inline attributes (inline SVG in HTML can conflict with host CSS)
|
|
264
|
-
7. **viewBox only, no width/height on root `<svg>`** — let the container handle sizing
|
|
265
|
-
8. **Use realistic but fictional data** — French locale, Swiss franc format (12'500.00 CHF), European dates (15.01.2026)
|
|
266
|
-
9. **Match the ASCII structure exactly** — same number of columns, same sections, same buttons. Do not add or remove UI elements.
|
|
267
|
-
10. **Ensure table columns match** — if ASCII shows 5 columns, SVG must show exactly 5 columns with the same headers
|
|
268
|
-
|
|
269
|
-
---
|
|
270
|
-
|
|
271
|
-
### Fallback
|
|
272
|
-
|
|
273
|
-
If you cannot produce a valid SVG (e.g., ASCII is too ambiguous or malformed), return EXACTLY the string:
|
|
274
|
-
```
|
|
275
|
-
FALLBACK_ASCII
|
|
276
|
-
```
|
|
277
|
-
This signals the system to use the ASCII wireframe instead.
|
|
278
|
-
|
|
279
|
-
---
|
|
280
|
-
|
|
281
|
-
## Orchestration Instructions
|
|
282
|
-
|
|
283
|
-
> **FOR the agent executing step-03d 11-bis or step-05b**: Follow this process to generate SVGs.
|
|
284
|
-
|
|
285
|
-
### Step-by-step process:
|
|
286
|
-
|
|
287
|
-
1. **Read** this file to get the prompt template (the "Agent Prompt Template" section above)
|
|
288
|
-
|
|
289
|
-
2. **Collect** all wireframes that need SVG:
|
|
290
|
-
```javascript
|
|
291
|
-
const wireframesToProcess = [];
|
|
292
|
-
for (const [moduleCode, wireframes] of Object.entries(EMBEDDED_ARTIFACTS.wireframes)) {
|
|
293
|
-
for (let i = 0; i < wireframes.length; i++) {
|
|
294
|
-
const wf = wireframes[i];
|
|
295
|
-
if (wf.content && !wf.svgContent) {
|
|
296
|
-
wireframesToProcess.push({ moduleCode, index: i, wf });
|
|
297
|
-
}
|
|
298
|
-
}
|
|
299
|
-
}
|
|
300
|
-
```
|
|
301
|
-
|
|
302
|
-
3. **Spawn parallel Task(sonnet) agents** — ONE per wireframe, ALL in a single message:
|
|
303
|
-
```
|
|
304
|
-
FOR EACH { moduleCode, index, wf } in wireframesToProcess:
|
|
305
|
-
Task(sonnet) prompt = this file's prompt template with substitutions:
|
|
306
|
-
{screenName} = wf.screen
|
|
307
|
-
{moduleName} = moduleCode
|
|
308
|
-
{sectionType} = wf.section
|
|
309
|
-
{asciiContent} = wf.content
|
|
310
|
-
{elementsJson} = JSON.stringify(wf.elements || [])
|
|
311
|
-
```
|
|
312
|
-
|
|
313
|
-
4. **Collect and validate** results:
|
|
314
|
-
```javascript
|
|
315
|
-
FOR EACH result:
|
|
316
|
-
// Strip markdown code fences if agent wrapped output
|
|
317
|
-
let svg = result.trim();
|
|
318
|
-
if (svg.startsWith('```')) {
|
|
319
|
-
svg = svg.replace(/^```(?:xml|svg|html)?\n?/, '').replace(/\n?```$/, '').trim();
|
|
320
|
-
}
|
|
321
|
-
|
|
322
|
-
IF svg starts with "<svg" AND svg contains "</svg>":
|
|
323
|
-
EMBEDDED_ARTIFACTS.wireframes[moduleCode][index].svgContent = svg
|
|
324
|
-
ELSE:
|
|
325
|
-
// Graceful fallback: leave svgContent as null
|
|
326
|
-
// HTML renders ASCII automatically
|
|
327
|
-
```
|
|
328
|
-
|
|
329
|
-
5. **Display summary** (non-blocking):
|
|
330
|
-
```
|
|
331
|
-
SVG wireframes: {generated}/{total} generated successfully
|
|
332
|
-
```
|
|
333
|
-
|
|
334
|
-
> **CRITICAL:** SVG generation is NEVER blocking. If all generations fail, deployment
|
|
335
|
-
> proceeds with ASCII-only wireframes. SVG is an enhancement, not a requirement.
|
|
1
|
+
# Wireframe SVG Style Guide
|
|
2
|
+
|
|
3
|
+
> **Purpose:** Self-contained specification for generating professional SVG wireframes from ASCII art.
|
|
4
|
+
> This document is sent as the FULL prompt to a Sonnet Task agent alongside the ASCII wireframe.
|
|
5
|
+
> Referenced by: `validate-incremental-html.md` (Step 3-bis), `step-05b-deploy.md` (Section 7-bis)
|
|
6
|
+
|
|
7
|
+
## Agent Prompt Template
|
|
8
|
+
|
|
9
|
+
> **USAGE:** Read this section, replace `{placeholders}` with actual wireframe data, send as the complete prompt to a Task(sonnet) agent. The agent returns ONLY the SVG markup string.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
You are a professional UI wireframe designer. Convert the following ASCII wireframe into a high-quality SVG wireframe that looks like a modern web application mockup.
|
|
14
|
+
|
|
15
|
+
### Input
|
|
16
|
+
|
|
17
|
+
**Screen name:** `{screenName}`
|
|
18
|
+
**Module:** `{moduleName}`
|
|
19
|
+
**Section type:** `{sectionType}` (list|detail|create|dashboard|approve)
|
|
20
|
+
**ASCII wireframe:**
|
|
21
|
+
```
|
|
22
|
+
{asciiContent}
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
**Element metadata (if available):**
|
|
26
|
+
```json
|
|
27
|
+
{elementsJson}
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### Output Requirements
|
|
31
|
+
|
|
32
|
+
Return ONLY the SVG markup as a single `<svg>` element. No explanation, no markdown, no code fences.
|
|
33
|
+
The SVG must be self-contained (no external fonts, no external CSS, no `<image>` tags).
|
|
34
|
+
|
|
35
|
+
### Visual Design System
|
|
36
|
+
|
|
37
|
+
#### Viewport & Canvas
|
|
38
|
+
- `viewBox="0 0 960 {dynamicHeight}"` — width fixed at 960, height adapts to content
|
|
39
|
+
- Minimum height: 540 for list views, 720 for detail views, 480 for dashboards
|
|
40
|
+
- Background: `#1e293b` (dark card background matching the HTML theme)
|
|
41
|
+
- 24px padding on all sides
|
|
42
|
+
- Root element: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 {height}">`
|
|
43
|
+
|
|
44
|
+
#### Color Palette (MUST use these exact colors)
|
|
45
|
+
|
|
46
|
+
| Role | Color | Usage |
|
|
47
|
+
|------|-------|-------|
|
|
48
|
+
| Background | `#1e293b` | Main canvas, card backgrounds |
|
|
49
|
+
| Surface | `#0f172a` | Input fields, table cells, nested panels |
|
|
50
|
+
| Border | `#334155` | All borders, dividers, table lines |
|
|
51
|
+
| Border light | `#475569` | Hover states, active borders |
|
|
52
|
+
| Primary | `#6366f1` | Primary buttons, active tabs, selected items |
|
|
53
|
+
| Primary hover | `#4f46e5` | Button hover state accent |
|
|
54
|
+
| Primary light | `#818cf8` | Links, column headers, highlighted text |
|
|
55
|
+
| Accent | `#06b6d4` | Secondary actions, info badges |
|
|
56
|
+
| Text bright | `#e2e8f0` | Headings, table header text, important labels |
|
|
57
|
+
| Text | `#b8c4d1` | Body text, table cell content |
|
|
58
|
+
| Text muted | `#8a9bb0` | Placeholders, secondary labels, pagination |
|
|
59
|
+
| Success | `#22c55e` | Active/approved status badges |
|
|
60
|
+
| Success bg | `rgba(34,197,94,0.15)` | Status badge background |
|
|
61
|
+
| Warning | `#eab308` | Pending/draft status badges |
|
|
62
|
+
| Warning bg | `rgba(234,179,8,0.15)` | Status badge background |
|
|
63
|
+
| Error | `#ef4444` | Error states, delete buttons |
|
|
64
|
+
| Gray | `#94a3b8` | Inactive/draft status |
|
|
65
|
+
| Gray bg | `rgba(100,116,139,0.15)` | Status badge background |
|
|
66
|
+
| Row hover | `rgba(99,102,241,0.05)` | Table row hover |
|
|
67
|
+
| Shadow | `rgba(0,0,0,0.25)` | Drop shadow for cards |
|
|
68
|
+
|
|
69
|
+
#### Typography (embedded via system fonts)
|
|
70
|
+
|
|
71
|
+
- Font family: `'Inter', 'Segoe UI', system-ui, sans-serif` (use `font-family` attribute on EVERY `<text>`)
|
|
72
|
+
- Page title: 18px, font-weight 600, color `#e2e8f0`
|
|
73
|
+
- Section heading: 14px, font-weight 600, color `#e2e8f0`
|
|
74
|
+
- Table header: 11px, font-weight 600, text-transform uppercase, letter-spacing 0.05em, color `#8a9bb0`
|
|
75
|
+
- Body text / table cells: 13px, font-weight 400, color `#b8c4d1`
|
|
76
|
+
- Button text: 13px, font-weight 500, color `#ffffff`
|
|
77
|
+
- Small text / badges: 11px, font-weight 500
|
|
78
|
+
- Placeholder text: 13px, font-weight 400, color `#8a9bb0`, font-style italic
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
### Component Patterns
|
|
83
|
+
|
|
84
|
+
#### Buttons (Primary)
|
|
85
|
+
```xml
|
|
86
|
+
<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="#6366f1"/>
|
|
87
|
+
<text x="{x+w/2}" y="{y+22}" text-anchor="middle"
|
|
88
|
+
font-family="Inter,Segoe UI,system-ui,sans-serif" font-size="13"
|
|
89
|
+
font-weight="500" fill="#ffffff">{label}</text>
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
#### Buttons (Secondary/Ghost)
|
|
93
|
+
```xml
|
|
94
|
+
<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="none" stroke="#334155" stroke-width="1"/>
|
|
95
|
+
<text x="{x+w/2}" y="{y+22}" text-anchor="middle"
|
|
96
|
+
font-family="Inter,Segoe UI,system-ui,sans-serif" font-size="13"
|
|
97
|
+
font-weight="500" fill="#b8c4d1">{label}</text>
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
#### Input Fields
|
|
101
|
+
```xml
|
|
102
|
+
<rect x="{x}" y="{y}" width="{w}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
|
|
103
|
+
<text x="{x+12}" y="{y+25}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
104
|
+
font-size="13" fill="#8a9bb0" font-style="italic">{placeholder}</text>
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
#### Search Bar (input with magnifying glass icon)
|
|
108
|
+
```xml
|
|
109
|
+
<rect x="{x}" y="{y}" width="{w}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
|
|
110
|
+
<circle cx="{x+22}" cy="{y+18}" r="7" fill="none" stroke="#8a9bb0" stroke-width="1.5"/>
|
|
111
|
+
<line x1="{x+27}" y1="{y+23}" x2="{x+31}" y2="{y+27}" stroke="#8a9bb0" stroke-width="1.5" stroke-linecap="round"/>
|
|
112
|
+
<text x="{x+40}" y="{y+25}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
113
|
+
font-size="13" fill="#8a9bb0" font-style="italic">Rechercher...</text>
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
#### Dropdown / Select
|
|
117
|
+
```xml
|
|
118
|
+
<rect x="{x}" y="{y}" width="{w}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
|
|
119
|
+
<text x="{x+12}" y="{y+25}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
120
|
+
font-size="13" fill="#b8c4d1">{selectedValue}</text>
|
|
121
|
+
<path d="M{x+w-24},{y+16} l6,8 l6,-8" fill="#8a9bb0"/>
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
#### Data Table
|
|
125
|
+
- Header row: background `#0f172a`, text uppercase 11px, color `#8a9bb0`, letter-spacing 0.05em
|
|
126
|
+
- Data rows: alternating `#1e293b` and `rgba(15,23,42,0.5)`, height 44px
|
|
127
|
+
- Row hover: one sample row with `rgba(99,102,241,0.05)` fill
|
|
128
|
+
- Column dividers: `stroke="#334155"` at 0.5 opacity
|
|
129
|
+
- Cell padding: 16px horizontal
|
|
130
|
+
- Header height: 40px
|
|
131
|
+
- Action column (rightmost): 3-dot vertical ellipsis menu icon
|
|
132
|
+
|
|
133
|
+
#### Status Badges
|
|
134
|
+
```xml
|
|
135
|
+
<!-- Active/Approved (green) -->
|
|
136
|
+
<rect x="{x}" y="{y}" width="{w}" height="22" rx="11" fill="rgba(34,197,94,0.15)"/>
|
|
137
|
+
<circle cx="{x+10}" cy="{y+11}" r="3" fill="#4ade80"/>
|
|
138
|
+
<text x="{x+18}" y="{y+15}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
139
|
+
font-size="11" font-weight="500" fill="#4ade80">{label}</text>
|
|
140
|
+
|
|
141
|
+
<!-- Pending/Warning (yellow) -->
|
|
142
|
+
<rect x="{x}" y="{y}" width="{w}" height="22" rx="11" fill="rgba(234,179,8,0.15)"/>
|
|
143
|
+
<circle cx="{x+10}" cy="{y+11}" r="3" fill="#facc15"/>
|
|
144
|
+
<text x="{x+18}" y="{y+15}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
145
|
+
font-size="11" font-weight="500" fill="#facc15">{label}</text>
|
|
146
|
+
|
|
147
|
+
<!-- Inactive/Draft (gray) -->
|
|
148
|
+
<rect x="{x}" y="{y}" width="{w}" height="22" rx="11" fill="rgba(100,116,139,0.15)"/>
|
|
149
|
+
<circle cx="{x+10}" cy="{y+11}" r="3" fill="#94a3b8"/>
|
|
150
|
+
<text x="{x+18}" y="{y+15}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
151
|
+
font-size="11" font-weight="500" fill="#94a3b8">{label}</text>
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
#### Cards / Panels
|
|
155
|
+
```xml
|
|
156
|
+
<defs>
|
|
157
|
+
<filter id="shadow" x="-2%" y="-2%" width="104%" height="104%">
|
|
158
|
+
<feDropShadow dx="0" dy="2" stdDeviation="4" flood-color="#000000" flood-opacity="0.25"/>
|
|
159
|
+
</filter>
|
|
160
|
+
</defs>
|
|
161
|
+
<rect x="{x}" y="{y}" width="{w}" height="{h}" rx="12" fill="#1e293b" stroke="#334155" stroke-width="1" filter="url(#shadow)"/>
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
#### Tabs
|
|
165
|
+
```xml
|
|
166
|
+
<!-- Active tab -->
|
|
167
|
+
<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="#6366f1"/>
|
|
168
|
+
<text x="{x+w/2}" y="{y+22}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
169
|
+
font-size="13" font-weight="500" fill="#ffffff">{label}</text>
|
|
170
|
+
|
|
171
|
+
<!-- Inactive tab -->
|
|
172
|
+
<rect x="{x}" y="{y}" width="{w}" height="36" rx="6" fill="transparent"/>
|
|
173
|
+
<text x="{x+w/2}" y="{y+22}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
174
|
+
font-size="13" font-weight="400" fill="#8a9bb0">{label}</text>
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
#### Pagination
|
|
178
|
+
```xml
|
|
179
|
+
<text x="{x}" y="{y}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
180
|
+
font-size="12" fill="#8a9bb0">1-25 de 142</text>
|
|
181
|
+
<!-- Active page -->
|
|
182
|
+
<rect x="{px}" y="{py}" width="28" height="28" rx="6" fill="#6366f1"/>
|
|
183
|
+
<text x="{px+14}" y="{py+18}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
184
|
+
font-size="12" font-weight="500" fill="#fff">1</text>
|
|
185
|
+
<!-- Inactive page -->
|
|
186
|
+
<rect x="{px+32}" y="{py}" width="28" height="28" rx="6" fill="none" stroke="#334155"/>
|
|
187
|
+
<text x="{px+46}" y="{py+18}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
188
|
+
font-size="12" fill="#8a9bb0">2</text>
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
#### KPI Cards (Dashboard)
|
|
192
|
+
```xml
|
|
193
|
+
<rect x="{x}" y="{y}" width="{w}" height="80" rx="8" fill="#334155"/>
|
|
194
|
+
<text x="{x+w/2}" y="{y+35}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
195
|
+
font-size="22" font-weight="700" fill="#e2e8f0">{value}</text>
|
|
196
|
+
<text x="{x+w/2}" y="{y+55}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
197
|
+
font-size="11" fill="#8a9bb0">{label}</text>
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
#### Chart Placeholder (Dashboard)
|
|
201
|
+
```xml
|
|
202
|
+
<rect x="{x}" y="{y}" width="{w}" height="180" rx="8" fill="none"
|
|
203
|
+
stroke="#334155" stroke-dasharray="6,4"/>
|
|
204
|
+
<text x="{x+w/2}" y="{y+90}" text-anchor="middle" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
205
|
+
font-size="13" fill="#8a9bb0">{chartLabel}</text>
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
#### Back Button / Navigation
|
|
209
|
+
```xml
|
|
210
|
+
<path d="M{x},{y+10} l-8,-10 l8,-10" fill="none" stroke="#818cf8" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
|
|
211
|
+
<text x="{x+8}" y="{y+5}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
212
|
+
font-size="13" font-weight="500" fill="#818cf8">Retour a la liste</text>
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
#### Form Layout (2-column)
|
|
216
|
+
```xml
|
|
217
|
+
<!-- Label -->
|
|
218
|
+
<text x="{x}" y="{y}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
219
|
+
font-size="12" font-weight="500" fill="#8a9bb0">{fieldLabel}</text>
|
|
220
|
+
<!-- Input below label (12px gap) -->
|
|
221
|
+
<rect x="{x}" y="{y+8}" width="{colWidth}" height="40" rx="6" fill="#0f172a" stroke="#334155" stroke-width="1"/>
|
|
222
|
+
<text x="{x+12}" y="{y+33}" font-family="Inter,Segoe UI,system-ui,sans-serif"
|
|
223
|
+
font-size="13" fill="#b8c4d1">{value or placeholder}</text>
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
---
|
|
227
|
+
|
|
228
|
+
### Section-Specific Layout Rules
|
|
229
|
+
|
|
230
|
+
**List Page Layout:**
|
|
231
|
+
1. Page header (title left + primary action button right) at y=24
|
|
232
|
+
2. Filter bar below header (search + dropdowns) at y=72
|
|
233
|
+
3. Data table occupying remaining space at y=128
|
|
234
|
+
4. Pagination bar at bottom
|
|
235
|
+
|
|
236
|
+
**Detail Page Layout:**
|
|
237
|
+
1. Back button + breadcrumb at y=24
|
|
238
|
+
2. Entity header (code + name + status badge + action buttons) at y=60
|
|
239
|
+
3. Horizontal divider at y=100
|
|
240
|
+
4. Tab bar at y=112
|
|
241
|
+
5. Active tab content area at y=160
|
|
242
|
+
|
|
243
|
+
**Create/Edit Form Layout:**
|
|
244
|
+
1. Form title at y=24
|
|
245
|
+
2. Two-column grid of form fields (label above input) starting at y=64
|
|
246
|
+
3. Horizontal divider before actions
|
|
247
|
+
4. Cancel + Submit buttons right-aligned at bottom
|
|
248
|
+
|
|
249
|
+
**Dashboard Layout:**
|
|
250
|
+
1. KPI cards in a 4-column grid at y=24
|
|
251
|
+
2. 2-column grid of chart placeholders at y=128
|
|
252
|
+
3. Optional filter bar above KPIs
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
### Quality Rules (MANDATORY)
|
|
257
|
+
|
|
258
|
+
1. **Every `<text>` element** MUST have the `font-family` attribute set
|
|
259
|
+
2. **No external dependencies** — no `<use>`, no `<image>`, no `xlink:href`
|
|
260
|
+
3. **All text must be readable** — contrast ratio >=4.5:1 on its background
|
|
261
|
+
4. **Consistent spacing** — 24px margin, 16px padding, 12px gap between form fields
|
|
262
|
+
5. **Rounded corners everywhere** — `rx="6"` minimum for interactive elements, `rx="12"` for cards
|
|
263
|
+
6. **No `<style>` blocks** — all styling via inline attributes (inline SVG in HTML can conflict with host CSS)
|
|
264
|
+
7. **viewBox only, no width/height on root `<svg>`** — let the container handle sizing
|
|
265
|
+
8. **Use realistic but fictional data** — French locale, Swiss franc format (12'500.00 CHF), European dates (15.01.2026)
|
|
266
|
+
9. **Match the ASCII structure exactly** — same number of columns, same sections, same buttons. Do not add or remove UI elements.
|
|
267
|
+
10. **Ensure table columns match** — if ASCII shows 5 columns, SVG must show exactly 5 columns with the same headers
|
|
268
|
+
|
|
269
|
+
---
|
|
270
|
+
|
|
271
|
+
### Fallback
|
|
272
|
+
|
|
273
|
+
If you cannot produce a valid SVG (e.g., ASCII is too ambiguous or malformed), return EXACTLY the string:
|
|
274
|
+
```
|
|
275
|
+
FALLBACK_ASCII
|
|
276
|
+
```
|
|
277
|
+
This signals the system to use the ASCII wireframe instead.
|
|
278
|
+
|
|
279
|
+
---
|
|
280
|
+
|
|
281
|
+
## Orchestration Instructions
|
|
282
|
+
|
|
283
|
+
> **FOR the agent executing step-03d 11-bis or step-05b**: Follow this process to generate SVGs.
|
|
284
|
+
|
|
285
|
+
### Step-by-step process:
|
|
286
|
+
|
|
287
|
+
1. **Read** this file to get the prompt template (the "Agent Prompt Template" section above)
|
|
288
|
+
|
|
289
|
+
2. **Collect** all wireframes that need SVG:
|
|
290
|
+
```javascript
|
|
291
|
+
const wireframesToProcess = [];
|
|
292
|
+
for (const [moduleCode, wireframes] of Object.entries(EMBEDDED_ARTIFACTS.wireframes)) {
|
|
293
|
+
for (let i = 0; i < wireframes.length; i++) {
|
|
294
|
+
const wf = wireframes[i];
|
|
295
|
+
if (wf.content && !wf.svgContent) {
|
|
296
|
+
wireframesToProcess.push({ moduleCode, index: i, wf });
|
|
297
|
+
}
|
|
298
|
+
}
|
|
299
|
+
}
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
3. **Spawn parallel Task(sonnet) agents** — ONE per wireframe, ALL in a single message:
|
|
303
|
+
```
|
|
304
|
+
FOR EACH { moduleCode, index, wf } in wireframesToProcess:
|
|
305
|
+
Task(sonnet) prompt = this file's prompt template with substitutions:
|
|
306
|
+
{screenName} = wf.screen
|
|
307
|
+
{moduleName} = moduleCode
|
|
308
|
+
{sectionType} = wf.section
|
|
309
|
+
{asciiContent} = wf.content
|
|
310
|
+
{elementsJson} = JSON.stringify(wf.elements || [])
|
|
311
|
+
```
|
|
312
|
+
|
|
313
|
+
4. **Collect and validate** results:
|
|
314
|
+
```javascript
|
|
315
|
+
FOR EACH result:
|
|
316
|
+
// Strip markdown code fences if agent wrapped output
|
|
317
|
+
let svg = result.trim();
|
|
318
|
+
if (svg.startsWith('```')) {
|
|
319
|
+
svg = svg.replace(/^```(?:xml|svg|html)?\n?/, '').replace(/\n?```$/, '').trim();
|
|
320
|
+
}
|
|
321
|
+
|
|
322
|
+
IF svg starts with "<svg" AND svg contains "</svg>":
|
|
323
|
+
EMBEDDED_ARTIFACTS.wireframes[moduleCode][index].svgContent = svg
|
|
324
|
+
ELSE:
|
|
325
|
+
// Graceful fallback: leave svgContent as null
|
|
326
|
+
// HTML renders ASCII automatically
|
|
327
|
+
```
|
|
328
|
+
|
|
329
|
+
5. **Display summary** (non-blocking):
|
|
330
|
+
```
|
|
331
|
+
SVG wireframes: {generated}/{total} generated successfully
|
|
332
|
+
```
|
|
333
|
+
|
|
334
|
+
> **CRITICAL:** SVG generation is NEVER blocking. If all generations fail, deployment
|
|
335
|
+
> proceeds with ASCII-only wireframes. SVG is an enhancement, not a requirement.
|