@polymorphism-tech/morph-spec 3.1.0 → 4.2.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 (333) hide show
  1. package/CLAUDE.md +882 -3
  2. package/README.md +79 -18
  3. package/bin/detect-agents.js +1 -1
  4. package/bin/morph-spec.js +163 -26
  5. package/bin/task-manager.cjs +101 -7
  6. package/bin/validate.js +1 -1
  7. package/docs/cli-auto-detection.md +219 -0
  8. package/docs/getting-started.md +0 -5
  9. package/docs/llm-interaction-config.md +735 -0
  10. package/docs/troubleshooting.md +269 -0
  11. package/docs/v3.0/AGENTS.md +521 -0
  12. package/docs/v3.0/ANALYSIS.md +555 -0
  13. package/docs/v3.0/ARCHITECTURE.md +436 -0
  14. package/docs/v3.0/EXECUTION-FLOW.md +1304 -0
  15. package/docs/v3.0/FEATURES.md +688 -0
  16. package/docs/v3.0/README.md +231 -0
  17. package/docs/v3.0/ROADMAP.md +801 -0
  18. package/docs/validation-checklist.md +0 -1
  19. package/package.json +5 -1
  20. package/src/commands/agents/index.js +4 -0
  21. package/src/commands/agents/spawn-team.js +172 -0
  22. package/src/commands/{create-story.js → feature/create-story.js} +357 -354
  23. package/src/commands/feature/index.js +6 -0
  24. package/src/commands/{shard-spec.js → feature/shard-spec.js} +2 -2
  25. package/src/commands/{sprint-status.js → feature/sprint-status.js} +1 -1
  26. package/src/commands/{generate-context.js → generation/generate-context.js} +40 -40
  27. package/src/commands/{generate.js → generation/generate.js} +130 -3
  28. package/src/commands/generation/index.js +5 -0
  29. package/src/commands/index.js +16 -0
  30. package/src/commands/learning/capture-pattern.js +121 -0
  31. package/src/commands/learning/index.js +5 -0
  32. package/src/commands/learning/search-patterns.js +126 -0
  33. package/src/commands/{detect-agents.js → project/detect-agents.js} +178 -178
  34. package/src/commands/project/detect-workflow.js +174 -0
  35. package/src/commands/{detect.js → project/detect.js} +104 -104
  36. package/src/commands/{doctor.js → project/doctor.js} +356 -356
  37. package/src/commands/project/index.js +10 -0
  38. package/src/commands/{init.js → project/init.js} +305 -258
  39. package/src/commands/{sync.js → project/sync.js} +167 -167
  40. package/src/commands/{update.js → project/update.js} +240 -204
  41. package/src/commands/{advance-phase.js → state/advance-phase.js} +416 -266
  42. package/src/commands/state/approve.js +221 -0
  43. package/src/commands/state/index.js +8 -0
  44. package/src/commands/{rollback-phase.js → state/rollback-phase.js} +185 -185
  45. package/src/commands/{state.js → state/state.js} +334 -334
  46. package/src/commands/{validate-phase.js → state/validate-phase.js} +221 -221
  47. package/src/commands/tasks/index.js +4 -0
  48. package/src/commands/{task.js → tasks/task.js} +78 -78
  49. package/src/commands/templates/index.js +8 -0
  50. package/src/commands/templates/template-customize.js +101 -0
  51. package/src/commands/templates/template-list.js +128 -0
  52. package/src/commands/templates/template-render.js +95 -0
  53. package/src/commands/templates/template-show.js +131 -0
  54. package/src/commands/templates/template-validate.js +91 -0
  55. package/src/commands/utils/index.js +7 -0
  56. package/src/commands/utils/migrate-state.js +158 -0
  57. package/src/commands/{session-summary.js → utils/session-summary.js} +291 -291
  58. package/src/commands/{troubleshoot.js → utils/troubleshoot.js} +222 -222
  59. package/src/commands/utils/upgrade.js +346 -0
  60. package/src/commands/{analyze-blazor-concurrency.js → validation/analyze-blazor-concurrency.js} +193 -193
  61. package/src/commands/validation/index.js +8 -0
  62. package/src/commands/{lint-fluent.js → validation/lint-fluent.js} +352 -352
  63. package/src/commands/{validate-blazor-state.js → validation/validate-blazor-state.js} +210 -210
  64. package/src/commands/{validate-blazor.js → validation/validate-blazor.js} +156 -156
  65. package/src/commands/{validate-css.js → validation/validate-css.js} +84 -84
  66. package/src/core/index.js +10 -0
  67. package/src/core/registry/command-registry.js +302 -0
  68. package/src/core/registry/index.js +8 -0
  69. package/src/core/registry/validator-registry.js +204 -0
  70. package/src/core/state/index.js +8 -0
  71. package/src/core/state/phase-state-machine.js +214 -0
  72. package/src/{lib → core/state}/state-manager.js +572 -414
  73. package/src/core/templates/index.js +9 -0
  74. package/src/core/templates/template-data-sources.js +325 -0
  75. package/src/core/templates/template-registry.js +335 -0
  76. package/src/core/templates/template-renderer.js +477 -0
  77. package/src/core/templates/template-validator.js +296 -0
  78. package/src/core/workflows/index.js +7 -0
  79. package/src/core/workflows/workflow-detector.js +354 -0
  80. package/src/generator/config-generator.js +206 -0
  81. package/src/generator/templates/config.json.template +40 -0
  82. package/src/generator/templates/project.md.template +67 -0
  83. package/src/lib/{complexity-analyzer.js → analysis/complexity-analyzer.js} +441 -441
  84. package/src/lib/analysis/index.js +7 -0
  85. package/src/lib/checkpoints/checkpoint-hooks.js +258 -0
  86. package/src/lib/checkpoints/index.js +7 -0
  87. package/src/lib/detectors/config-detector.js +223 -223
  88. package/src/lib/detectors/conversation-analyzer.js +163 -163
  89. package/src/lib/{design-system-detector.js → detectors/design-system-detector.js} +187 -187
  90. package/src/lib/detectors/index.js +87 -84
  91. package/src/lib/detectors/standards-generator.js +275 -275
  92. package/src/lib/detectors/structure-detector.js +245 -245
  93. package/src/lib/{context-generator.js → generators/context-generator.js} +526 -516
  94. package/src/lib/generators/index.js +10 -0
  95. package/src/lib/generators/metadata-extractor.js +387 -0
  96. package/src/lib/{recap-generator.js → generators/recap-generator.js} +205 -205
  97. package/src/lib/learning/index.js +7 -0
  98. package/src/lib/orchestration/index.js +7 -0
  99. package/src/lib/{team-orchestrator.js → orchestration/team-orchestrator.js} +323 -323
  100. package/src/lib/stacks/index.js +7 -0
  101. package/src/lib/{stack-resolver.js → stacks/stack-resolver.js} +180 -148
  102. package/src/lib/standards/index.js +7 -0
  103. package/src/lib/{standards-context-injector.js → standards/standards-context-injector.js} +298 -288
  104. package/src/lib/troubleshooting/index.js +8 -0
  105. package/src/lib/{troubleshoot-grep.js → troubleshooting/troubleshoot-grep.js} +204 -204
  106. package/src/lib/{troubleshoot-index.js → troubleshooting/troubleshoot-index.js} +144 -144
  107. package/src/lib/validators/architecture/architecture-validator.js +387 -0
  108. package/src/lib/validators/architecture/index.js +7 -0
  109. package/src/lib/validators/architecture-validator.js +40 -367
  110. package/src/lib/{blazor-concurrency-analyzer.js → validators/blazor/blazor-concurrency-analyzer.js} +277 -288
  111. package/src/lib/{blazor-state-validator.js → validators/blazor/blazor-state-validator.js} +279 -291
  112. package/src/lib/{blazor-validator.js → validators/blazor/blazor-validator.js} +369 -374
  113. package/src/lib/validators/blazor/index.js +9 -0
  114. package/src/lib/validators/content/content-validator.js +351 -0
  115. package/src/lib/validators/content/index.js +7 -0
  116. package/src/lib/validators/content-validator.js +164 -0
  117. package/src/lib/validators/{contract-compliance-validator.js → contracts/contract-compliance-validator.js} +273 -273
  118. package/src/lib/validators/contracts/index.js +7 -0
  119. package/src/lib/{css-validator.js → validators/css/css-validator.js} +352 -352
  120. package/src/lib/validators/css/index.js +7 -0
  121. package/src/lib/validators/{design-system-validator.js → design-system/design-system-validator.js} +231 -231
  122. package/src/lib/validators/design-system/index.js +7 -0
  123. package/src/lib/validators/package-validator.js +41 -340
  124. package/src/lib/validators/packages/index.js +7 -0
  125. package/src/lib/validators/packages/package-validator.js +360 -0
  126. package/src/lib/validators/shared/index.js +12 -0
  127. package/src/lib/validators/shared/issue-counter.js +18 -0
  128. package/src/lib/validators/shared/result-formatter.js +124 -0
  129. package/src/lib/{spec-validator.js → validators/spec-validator.js} +258 -258
  130. package/src/lib/validators/ui/index.js +7 -0
  131. package/src/lib/validators/ui/ui-contrast-validator.js +422 -0
  132. package/src/lib/validators/ui-contrast-validator.js +31 -409
  133. package/src/lib/{validation-runner.js → validators/validation-runner.js} +286 -284
  134. package/src/llm/analyzer.js +215 -0
  135. package/src/llm/environment-detector.js +43 -0
  136. package/src/llm/few-shot-examples.js +216 -0
  137. package/src/llm/project-config-schema.json +188 -0
  138. package/src/llm/prompt-builder.js +96 -0
  139. package/src/orchestrator.js +206 -0
  140. package/src/sanitizer/context-sanitizer.js +221 -0
  141. package/src/sanitizer/patterns.js +163 -0
  142. package/src/scanner/project-scanner.js +242 -0
  143. package/src/ui/diff-display.js +91 -0
  144. package/src/ui/interactive-wizard.js +96 -0
  145. package/src/ui/user-review.js +211 -0
  146. package/src/ui/wizard-questions.js +188 -0
  147. package/src/utils/color-utils.js +70 -0
  148. package/src/utils/file-copier.js +188 -189
  149. package/src/utils/process-handler.js +97 -0
  150. package/src/writer/file-writer.js +86 -0
  151. package/stacks/blazor-azure/.claude/skills/level-2-domains/ai-agents/ai-system-architect.md +3 -3
  152. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/api-designer.md +59 -0
  153. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/dotnet-senior.md +45 -255
  154. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/ef-modeler.md +33 -88
  155. package/stacks/blazor-azure/.claude/skills/level-2-domains/backend/ms-agent-expert.md +25 -89
  156. package/stacks/blazor-azure/.claude/skills/level-2-domains/integrations/hangfire-orchestrator.md +64 -0
  157. package/stacks/blazor-azure/.morph/config/agents.json +879 -764
  158. package/stacks/blazor-azure/.morph/hooks/{pre-commit-tests.sh → pre-commit/tests-csharp.sh} +3 -2
  159. package/stacks/blazor-azure/.morph/templates/.gitkeep +0 -0
  160. package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs +41 -0
  161. package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/cd-staging.yml.hbs +24 -0
  162. package/stacks/blazor-azure/.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs +23 -0
  163. package/stacks/nextjs-supabase/.claude/commands/morph-apply.md +221 -0
  164. package/stacks/nextjs-supabase/.claude/commands/morph-archive.md +79 -0
  165. package/stacks/nextjs-supabase/.claude/commands/morph-deploy.md +529 -0
  166. package/stacks/nextjs-supabase/.claude/commands/morph-infra.md +209 -0
  167. package/stacks/nextjs-supabase/.claude/commands/morph-preflight.md +227 -0
  168. package/stacks/nextjs-supabase/.claude/commands/morph-proposal.md +122 -0
  169. package/stacks/nextjs-supabase/.claude/commands/morph-status.md +86 -0
  170. package/stacks/nextjs-supabase/.claude/commands/morph-troubleshoot.md +122 -0
  171. package/stacks/nextjs-supabase/.claude/settings.local.json +6 -0
  172. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/integrations/supabase-expert.md +30 -150
  173. package/stacks/nextjs-supabase/.morph/config/agents.json +345 -345
  174. package/stacks/nextjs-supabase/.morph/hooks/pre-commit/tests-typescript.sh +61 -0
  175. package/stacks/nextjs-supabase/.morph/templates/.gitkeep +0 -0
  176. package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/cd-prod.yml.hbs +22 -0
  177. package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/cd-staging.yml.hbs +22 -0
  178. package/stacks/nextjs-supabase/.morph/templates/infrastructure/github/workflows/ci-build.yml.hbs +35 -0
  179. package/stacks/nextjs-supabase/README.md +6 -15
  180. package/bin/render-template.js +0 -303
  181. package/bin/semantic-detect-agents.js +0 -247
  182. package/bin/validate-agents-skills.js +0 -257
  183. package/bin/validate-agents.js +0 -70
  184. package/bin/validate-phase.js +0 -263
  185. package/docs/examples.md +0 -328
  186. package/scripts/reorganize-skills.cjs +0 -175
  187. package/scripts/validate-agents-structure.cjs +0 -52
  188. package/scripts/validate-skills.cjs +0 -180
  189. package/src/commands/deploy.js +0 -780
  190. package/src/lib/continuous-validator.js +0 -421
  191. package/src/lib/decision-constraint-loader.js +0 -109
  192. package/src/lib/design-system-scaffolder.js +0 -299
  193. package/src/lib/hook-executor.js +0 -257
  194. package/src/lib/mockup-generator.js +0 -366
  195. package/src/lib/ui-detector.js +0 -350
  196. package/stacks/blazor-azure/.azure/README.md +0 -293
  197. package/stacks/blazor-azure/.azure/docs/azure-devops-setup.md +0 -454
  198. package/stacks/blazor-azure/.azure/docs/branch-strategy.md +0 -398
  199. package/stacks/blazor-azure/.azure/docs/local-development.md +0 -515
  200. package/stacks/blazor-azure/.azure/pipelines/pipeline-variables.yml +0 -34
  201. package/stacks/blazor-azure/.azure/pipelines/prod-pipeline.yml +0 -319
  202. package/stacks/blazor-azure/.azure/pipelines/staging-pipeline.yml +0 -234
  203. package/stacks/blazor-azure/.azure/pipelines/templates/build-dotnet.yml +0 -75
  204. package/stacks/blazor-azure/.azure/pipelines/templates/deploy-app-service.yml +0 -94
  205. package/stacks/blazor-azure/.azure/pipelines/templates/deploy-container-app.yml +0 -120
  206. package/stacks/blazor-azure/.azure/pipelines/templates/infra-deploy.yml +0 -90
  207. package/stacks/blazor-azure/.claude/settings.local.json +0 -15
  208. package/stacks/blazor-azure/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +0 -392
  209. package/stacks/blazor-azure/.morph/docs/workflows/design-impl.md +0 -37
  210. package/stacks/blazor-azure/.morph/docs/workflows/enforcement-pipeline.md +0 -668
  211. package/stacks/blazor-azure/.morph/docs/workflows/fast-track.md +0 -29
  212. package/stacks/blazor-azure/.morph/docs/workflows/full-morph.md +0 -76
  213. package/stacks/blazor-azure/.morph/docs/workflows/standard.md +0 -44
  214. package/stacks/blazor-azure/.morph/docs/workflows/ui-refresh.md +0 -39
  215. package/stacks/blazor-azure/.morph/examples/api-nextjs/README.md +0 -241
  216. package/stacks/blazor-azure/.morph/examples/api-nextjs/contracts.ts +0 -307
  217. package/stacks/blazor-azure/.morph/examples/api-nextjs/spec.md +0 -399
  218. package/stacks/blazor-azure/.morph/examples/api-nextjs/tasks.md +0 -168
  219. package/stacks/blazor-azure/.morph/examples/micro-saas/README.md +0 -125
  220. package/stacks/blazor-azure/.morph/examples/micro-saas/contracts.cs +0 -358
  221. package/stacks/blazor-azure/.morph/examples/micro-saas/decisions.md +0 -246
  222. package/stacks/blazor-azure/.morph/examples/micro-saas/spec.md +0 -236
  223. package/stacks/blazor-azure/.morph/examples/micro-saas/tasks.md +0 -150
  224. package/stacks/blazor-azure/.morph/examples/multi-agent/README.md +0 -309
  225. package/stacks/blazor-azure/.morph/examples/multi-agent/contracts.cs +0 -433
  226. package/stacks/blazor-azure/.morph/examples/multi-agent/spec.md +0 -479
  227. package/stacks/blazor-azure/.morph/examples/multi-agent/tasks.md +0 -185
  228. package/stacks/blazor-azure/.morph/examples/scheduled-reports/decisions.md +0 -158
  229. package/stacks/blazor-azure/.morph/examples/scheduled-reports/proposal.md +0 -95
  230. package/stacks/blazor-azure/.morph/examples/scheduled-reports/spec.md +0 -267
  231. package/stacks/blazor-azure/.morph/examples/state-v3.json +0 -188
  232. package/stacks/blazor-azure/.morph/hooks/README.md +0 -348
  233. package/stacks/blazor-azure/.morph/hooks/pre-commit-agents.sh +0 -24
  234. package/stacks/blazor-azure/.morph/hooks/pre-commit-all.sh +0 -48
  235. package/stacks/blazor-azure/.morph/hooks/pre-commit-specs.sh +0 -49
  236. package/stacks/blazor-azure/.morph/hooks/task-completed.js +0 -73
  237. package/stacks/blazor-azure/.morph/hooks/teammate-idle.js +0 -68
  238. package/stacks/blazor-azure/.morph/standards/agent-framework-blazor-ui.md +0 -359
  239. package/stacks/blazor-azure/.morph/standards/agent-framework-production.md +0 -410
  240. package/stacks/blazor-azure/.morph/standards/agent-framework-setup.md +0 -413
  241. package/stacks/blazor-azure/.morph/standards/agent-framework-workflows.md +0 -349
  242. package/stacks/blazor-azure/.morph/standards/agent-teams-workflow.md +0 -474
  243. package/stacks/blazor-azure/.morph/standards/architecture.md +0 -325
  244. package/stacks/blazor-azure/.morph/standards/azure.md +0 -605
  245. package/stacks/blazor-azure/.morph/standards/coding.md +0 -377
  246. package/stacks/blazor-azure/.morph/standards/dotnet10-migration.md +0 -520
  247. package/stacks/blazor-azure/.morph/standards/fluent-ui-setup.md +0 -590
  248. package/stacks/blazor-azure/.morph/standards/migration-guide.md +0 -514
  249. package/stacks/blazor-azure/.morph/standards/passkeys-auth.md +0 -423
  250. package/stacks/blazor-azure/.morph/standards/vector-search-rag.md +0 -536
  251. package/stacks/blazor-azure/.morph/templates/CONTEXT-FEATURE.md +0 -276
  252. package/stacks/blazor-azure/.morph/templates/CONTEXT.md +0 -170
  253. package/stacks/blazor-azure/.morph/templates/FluentDesignTheme.cs +0 -149
  254. package/stacks/blazor-azure/.morph/templates/MudTheme.cs +0 -281
  255. package/stacks/blazor-azure/.morph/templates/agent.cs +0 -163
  256. package/stacks/blazor-azure/.morph/templates/clarify-questions.md +0 -159
  257. package/stacks/blazor-azure/.morph/templates/component.razor +0 -239
  258. package/stacks/blazor-azure/.morph/templates/contracts/Commands.cs +0 -74
  259. package/stacks/blazor-azure/.morph/templates/contracts/Entities.cs +0 -25
  260. package/stacks/blazor-azure/.morph/templates/contracts/Queries.cs +0 -74
  261. package/stacks/blazor-azure/.morph/templates/contracts/README.md +0 -74
  262. package/stacks/blazor-azure/.morph/templates/contracts.cs +0 -217
  263. package/stacks/blazor-azure/.morph/templates/decisions.md +0 -123
  264. package/stacks/blazor-azure/.morph/templates/design-system.css +0 -226
  265. package/stacks/blazor-azure/.morph/templates/infra/.dockerignore.example +0 -89
  266. package/stacks/blazor-azure/.morph/templates/infra/Dockerfile.example +0 -82
  267. package/stacks/blazor-azure/.morph/templates/infra/README.md +0 -286
  268. package/stacks/blazor-azure/.morph/templates/infra/app-insights.bicep +0 -63
  269. package/stacks/blazor-azure/.morph/templates/infra/app-service.bicep +0 -164
  270. package/stacks/blazor-azure/.morph/templates/infra/azure-pipelines-deploy.yml +0 -480
  271. package/stacks/blazor-azure/.morph/templates/infra/container-app-env.bicep +0 -49
  272. package/stacks/blazor-azure/.morph/templates/infra/container-app.bicep +0 -156
  273. package/stacks/blazor-azure/.morph/templates/infra/deploy-checklist.md +0 -426
  274. package/stacks/blazor-azure/.morph/templates/infra/deploy.ps1 +0 -229
  275. package/stacks/blazor-azure/.morph/templates/infra/deploy.sh +0 -208
  276. package/stacks/blazor-azure/.morph/templates/infra/key-vault.bicep +0 -91
  277. package/stacks/blazor-azure/.morph/templates/infra/main.bicep +0 -189
  278. package/stacks/blazor-azure/.morph/templates/infra/parameters.dev.json +0 -29
  279. package/stacks/blazor-azure/.morph/templates/infra/parameters.prod.json +0 -29
  280. package/stacks/blazor-azure/.morph/templates/infra/parameters.staging.json +0 -29
  281. package/stacks/blazor-azure/.morph/templates/infra/sql-database.bicep +0 -103
  282. package/stacks/blazor-azure/.morph/templates/infra/storage.bicep +0 -106
  283. package/stacks/blazor-azure/.morph/templates/integrations/asaas-client.cs +0 -387
  284. package/stacks/blazor-azure/.morph/templates/integrations/asaas-webhook.cs +0 -351
  285. package/stacks/blazor-azure/.morph/templates/integrations/azure-identity-config.cs +0 -288
  286. package/stacks/blazor-azure/.morph/templates/integrations/clerk-config.cs +0 -258
  287. package/stacks/blazor-azure/.morph/templates/job.cs +0 -171
  288. package/stacks/blazor-azure/.morph/templates/migration.cs +0 -83
  289. package/stacks/blazor-azure/.morph/templates/proposal.md +0 -141
  290. package/stacks/blazor-azure/.morph/templates/recap.md +0 -94
  291. package/stacks/blazor-azure/.morph/templates/repository.cs +0 -141
  292. package/stacks/blazor-azure/.morph/templates/saas/subscription.cs +0 -347
  293. package/stacks/blazor-azure/.morph/templates/saas/tenant.cs +0 -338
  294. package/stacks/blazor-azure/.morph/templates/service.cs +0 -139
  295. package/stacks/blazor-azure/.morph/templates/simulation.md +0 -353
  296. package/stacks/blazor-azure/.morph/templates/spec.md +0 -149
  297. package/stacks/blazor-azure/.morph/templates/sprint-status.yaml +0 -68
  298. package/stacks/blazor-azure/.morph/templates/state.template.json +0 -222
  299. package/stacks/blazor-azure/.morph/templates/story.md +0 -143
  300. package/stacks/blazor-azure/.morph/templates/tasks.md +0 -257
  301. package/stacks/blazor-azure/.morph/templates/test.cs +0 -239
  302. package/stacks/blazor-azure/.morph/templates/ui-components.md +0 -362
  303. package/stacks/blazor-azure/.morph/templates/ui-design-system.md +0 -286
  304. package/stacks/blazor-azure/.morph/templates/ui-flows.md +0 -336
  305. package/stacks/blazor-azure/.morph/templates/ui-mockups.md +0 -133
  306. package/stacks/nextjs-supabase/.morph/docs/easypanel-setup.md +0 -169
  307. package/stacks/nextjs-supabase/.morph/docs/supabase-mcp-setup.md +0 -247
  308. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/README.md +0 -697
  309. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/spec.md +0 -85
  310. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/tasks.md +0 -86
  311. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/README.md +0 -498
  312. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/decisions.md +0 -121
  313. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/spec.md +0 -138
  314. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/tasks.md +0 -162
  315. package/stacks/nextjs-supabase/.morph/standards/easypanel-deploy.md +0 -191
  316. package/stacks/nextjs-supabase/.morph/standards/nextjs-patterns.md +0 -193
  317. package/stacks/nextjs-supabase/.morph/standards/supabase-auth.md +0 -171
  318. package/stacks/nextjs-supabase/.morph/standards/supabase-pgvector.md +0 -164
  319. package/stacks/nextjs-supabase/.morph/standards/supabase-rls.md +0 -179
  320. package/stacks/nextjs-supabase/.morph/standards/supabase-storage.md +0 -148
  321. package/stacks/nextjs-supabase/.morph/templates/contracts.cs +0 -173
  322. package/stacks/nextjs-supabase/.morph/templates/contracts.ts +0 -168
  323. package/stacks/nextjs-supabase/.morph/templates/decisions.md +0 -115
  324. package/stacks/nextjs-supabase/.morph/templates/dockerfile-api.dockerfile +0 -38
  325. package/stacks/nextjs-supabase/.morph/templates/dockerfile-web.dockerfile +0 -48
  326. package/stacks/nextjs-supabase/.morph/templates/proposal.md +0 -145
  327. package/stacks/nextjs-supabase/.morph/templates/recap.md +0 -134
  328. package/stacks/nextjs-supabase/.morph/templates/rls-policy.sql +0 -57
  329. package/stacks/nextjs-supabase/.morph/templates/spec.md +0 -231
  330. package/stacks/nextjs-supabase/.morph/templates/supabase-migration.sql +0 -100
  331. package/stacks/nextjs-supabase/.morph/templates/tasks.md +0 -257
  332. /package/src/lib/{design-system-generator.js → generators/design-system-generator.js} +0 -0
  333. /package/src/lib/{learning-system.js → learning/learning-system.js} +0 -0
@@ -1,345 +1,345 @@
1
- {
2
- "$schema": "./agent-schema.json",
3
- "version": "3.0.0-hierarchical",
4
- "stack": "nextjs-supabase",
5
- "total_agents": 12,
6
- "tiers": {
7
- "tier_1_orchestrators": 1,
8
- "tier_2_leaders": 2,
9
- "tier_3_specialists": 8,
10
- "tier_4_validators": 1
11
- },
12
-
13
- "agents": {
14
-
15
- "_comment_tier_1": "=== TIER 1: ORCHESTRATORS (1) ===",
16
-
17
- "standards-architect": {
18
- "tier": 1,
19
- "role": "orchestrator",
20
- "title": "Chief Architect",
21
- "domains": ["architecture", "developer-experience"],
22
- "keywords": [],
23
- "always_active": true,
24
- "validators": ["architecture", "packages"],
25
- "relationships": {
26
- "reports_to": "user",
27
- "coordinates": ["dotnet-senior", "supabase-expert", "nextjs-expert", "testing-specialist", "ui-ux-designer"],
28
- "escalates_to": "user",
29
- "team_role": "lead"
30
- },
31
- "standards": ["coding.md", "architecture.md", "nextjs-patterns.md", "supabase-auth.md", "supabase-rls.md"],
32
- "teammate": {
33
- "role": "Team Lead (Delegate Mode)",
34
- "icon": "T",
35
- "spawn_prompt": "You are the Chief Architect and Team Lead in delegate mode. Coordinate specialists, resolve conflicts, synthesize results. DO NOT implement code yourself. Escalate conflicts to user when teammates disagree on architecture/tech choices."
36
- }
37
- },
38
-
39
- "_comment_tier_2": "=== TIER 2: DOMAIN LEADERS (2) ===",
40
-
41
- "dotnet-senior": {
42
- "tier": 2,
43
- "role": "domain-leader",
44
- "title": "Backend Squad Leader",
45
- "domains": ["backend"],
46
- "keywords": ["backend", "api", "dotnet", ".net", "csharp", "c#", "minimal api", "endpoint", "dapper", "npgsql"],
47
- "always_active": true,
48
- "validators": ["architecture", "packages"],
49
- "relationships": {
50
- "reports_to": "standards-architect",
51
- "coordinates": ["api-designer", "testing-specialist"],
52
- "escalates_to": "standards-architect",
53
- "collaborates_with": ["supabase-expert", "nextjs-expert", "container-specialist"],
54
- "team_role": "domain_leader"
55
- },
56
- "standards": ["coding.md", "architecture.md"],
57
- "teammate": {
58
- "role": "Backend Squad Leader",
59
- "icon": "B",
60
- "spawn_prompt": "You are the Backend Squad Leader. .NET 10 Minimal API with Npgsql + Dapper (NOT EF Core). Coordinate backend specialists. Validate Supabase JWT tokens in API middleware. Assign tasks, review designs, enforce backend standards. Escalate cross-domain conflicts to standards-architect."
61
- }
62
- },
63
-
64
- "ui-ux-designer": {
65
- "tier": 2,
66
- "role": "domain-leader",
67
- "title": "UI/UX Squad Leader",
68
- "domains": ["frontend-design"],
69
- "keywords": ["wireframe", "mockup", "user flow", "ux", "design", "interface design", "user experience", "page", "dashboard", "form", "UI", "screen", "panel"],
70
- "always_active": false,
71
- "validators": ["design-system", "contrast"],
72
- "relationships": {
73
- "reports_to": "standards-architect",
74
- "coordinates": ["nextjs-expert", "css-specialist"],
75
- "escalates_to": "standards-architect",
76
- "collaborates_with": ["dotnet-senior"],
77
- "team_role": "domain_leader",
78
- "active_phases": ["uiux"]
79
- },
80
- "standards": ["css-naming.md", "nextjs-patterns.md"],
81
- "teammate": {
82
- "role": "UI/UX Squad Leader",
83
- "icon": "U",
84
- "spawn_prompt": "You are the UI/UX Squad Leader. Create wireframes, mockups, user flows. Define design system (colors, typography, spacing) using Tailwind CSS tokens. Coordinate with nextjs-expert and css-specialist for implementation. Work is AGNOSTIC (no implementation code)."
85
- }
86
- },
87
-
88
- "_comment_tier_3": "=== TIER 3: SPECIALISTS (8) ===",
89
-
90
- "nextjs-expert": {
91
- "tier": 3,
92
- "role": "specialist",
93
- "title": "Next.js Development Specialist",
94
- "domains": ["frontend-nextjs"],
95
- "keywords": ["nextjs", "next.js", "react", "frontend", "shadcn", "server components", "server actions", "app router", "tanstack"],
96
- "always_active": false,
97
- "validators": ["packages", "css", "design-system"],
98
- "relationships": {
99
- "reports_to": "ui-ux-designer",
100
- "coordinates": [],
101
- "escalates_to": "standards-architect",
102
- "collaborates_with": ["api-designer", "css-specialist", "supabase-expert"],
103
- "team_role": "specialist",
104
- "active_phases": ["uiux", "implement"]
105
- },
106
- "standards": ["coding.md", "nextjs-patterns.md"],
107
- "teammate": {
108
- "role": "Next.js Development Specialist",
109
- "icon": "N",
110
- "spawn_prompt": "You are the Next.js 15 Development Specialist. Build App Router pages with shadcn/ui components. Use @supabase/ssr for auth (NOT Clerk). Implement Server Components, Server Actions, Route Handlers. Use TanStack Query for client-side data fetching. Message api-designer for backend endpoints."
111
- }
112
- },
113
-
114
- "api-designer": {
115
- "tier": 3,
116
- "role": "specialist",
117
- "title": "API Design Specialist",
118
- "domains": ["backend-api"],
119
- "keywords": ["rest", "api", "openapi", "swagger", "endpoint", "minimal api", "route", "versioning", "rate limiting"],
120
- "always_active": false,
121
- "validators": ["architecture"],
122
- "relationships": {
123
- "reports_to": "dotnet-senior",
124
- "coordinates": [],
125
- "escalates_to": "dotnet-senior",
126
- "collaborates_with": ["supabase-expert", "nextjs-expert"],
127
- "team_role": "specialist"
128
- },
129
- "standards": ["coding.md", "architecture.md"],
130
- "teammate": {
131
- "role": "API Design Specialist",
132
- "icon": "A",
133
- "spawn_prompt": "You are the API Design Specialist. Design REST APIs using .NET 10 Minimal API (MapGet, MapPost, etc.). Use endpoint groups, typed results, OpenAPI annotations. Implement API versioning, rate limiting. Validate Supabase JWT in middleware."
134
- }
135
- },
136
-
137
- "supabase-expert": {
138
- "tier": 3,
139
- "role": "specialist",
140
- "title": "Supabase Platform Specialist",
141
- "domains": ["platform-supabase"],
142
- "keywords": ["supabase", "postgres", "postgresql", "rls", "row level security", "auth", "storage", "realtime", "pgvector", "migration", "database", "policy"],
143
- "always_active": true,
144
- "validators": ["architecture"],
145
- "relationships": {
146
- "reports_to": "standards-architect",
147
- "coordinates": [],
148
- "escalates_to": "standards-architect",
149
- "collaborates_with": ["dotnet-senior", "nextjs-expert", "security-expert"],
150
- "team_role": "specialist"
151
- },
152
- "standards": ["supabase-auth.md", "supabase-rls.md", "supabase-storage.md", "supabase-pgvector.md"],
153
- "teammate": {
154
- "role": "Supabase Platform Specialist",
155
- "icon": "S",
156
- "spawn_prompt": "You are the Supabase Platform Specialist. Design PostgreSQL schemas (snake_case), write SQL migrations, create RLS policies for multi-tenant security. Configure Supabase Auth (Google + GitHub OAuth), Storage buckets with policies, Realtime subscriptions. Implement pgvector for vector search when needed. Collaborate with security-expert for RLS audit."
157
- }
158
- },
159
-
160
- "easypanel-deployer": {
161
- "tier": 3,
162
- "role": "specialist",
163
- "title": "EasyPanel Deployment Specialist",
164
- "domains": ["infrastructure-deploy"],
165
- "keywords": ["easypanel", "deploy", "deployment", "hosting", "ssl", "domain", "vps", "production"],
166
- "always_active": false,
167
- "validators": ["architecture"],
168
- "relationships": {
169
- "reports_to": "standards-architect",
170
- "coordinates": [],
171
- "escalates_to": "standards-architect",
172
- "collaborates_with": ["container-specialist", "devops-engineer"],
173
- "team_role": "specialist"
174
- },
175
- "standards": ["easypanel-deploy.md"],
176
- "teammate": {
177
- "role": "EasyPanel Deployment Specialist",
178
- "icon": "E",
179
- "spawn_prompt": "You are the EasyPanel Deployment Specialist. Configure EasyPanel services (API + Web), set up GitHub integration for auto-deploy, manage SSL certificates and custom domains. Define environment variables, health check endpoints, resource limits."
180
- }
181
- },
182
-
183
- "container-specialist": {
184
- "tier": 3,
185
- "role": "specialist",
186
- "title": "Containerization Specialist",
187
- "domains": ["infrastructure-containers"],
188
- "keywords": ["docker", "container", "dockerfile", "multi-stage", "docker compose", "health check", "image"],
189
- "always_active": true,
190
- "validators": ["architecture"],
191
- "relationships": {
192
- "reports_to": "standards-architect",
193
- "coordinates": [],
194
- "escalates_to": "standards-architect",
195
- "collaborates_with": ["easypanel-deployer", "devops-engineer", "dotnet-senior", "nextjs-expert"],
196
- "team_role": "specialist"
197
- },
198
- "standards": ["easypanel-deploy.md"],
199
- "teammate": {
200
- "role": "Containerization Specialist",
201
- "icon": "D",
202
- "spawn_prompt": "You are the Containerization Specialist for EasyPanel deployments. Write multi-stage Dockerfiles (.NET API + Next.js), docker-compose.yml for local dev, .dockerignore files. Optimize image sizes, configure health checks (/health endpoint). Target EasyPanel container service format."
203
- }
204
- },
205
-
206
- "devops-engineer": {
207
- "tier": 3,
208
- "role": "specialist",
209
- "title": "CI/CD Specialist",
210
- "domains": ["infrastructure-cicd"],
211
- "keywords": ["pipeline", "ci/cd", "github actions", "auto-deploy", "workflow", "continuous integration"],
212
- "always_active": false,
213
- "validators": ["architecture"],
214
- "relationships": {
215
- "reports_to": "standards-architect",
216
- "coordinates": [],
217
- "escalates_to": "standards-architect",
218
- "collaborates_with": ["container-specialist", "easypanel-deployer"],
219
- "team_role": "specialist"
220
- },
221
- "standards": ["easypanel-deploy.md"],
222
- "teammate": {
223
- "role": "CI/CD Specialist",
224
- "icon": "C",
225
- "spawn_prompt": "You are the CI/CD Specialist. Build GitHub Actions workflows for .NET build/test + Next.js build/test. Configure auto-deploy to EasyPanel via GitHub webhook or API. Implement environment-based deployments (staging, production)."
226
- }
227
- },
228
-
229
- "css-specialist": {
230
- "tier": 3,
231
- "role": "specialist",
232
- "title": "CSS & Design System Specialist",
233
- "domains": ["frontend-css"],
234
- "keywords": ["css", "tailwind", "design system", "styling", "theme", "design tokens", "shadcn"],
235
- "always_active": false,
236
- "validators": ["css", "contrast", "design-system"],
237
- "relationships": {
238
- "reports_to": "ui-ux-designer",
239
- "coordinates": [],
240
- "escalates_to": "ui-ux-designer",
241
- "collaborates_with": ["nextjs-expert"],
242
- "team_role": "specialist",
243
- "active_phases": ["implement"]
244
- },
245
- "standards": ["css-naming.md", "nextjs-patterns.md"],
246
- "teammate": {
247
- "role": "CSS & Design System Specialist",
248
- "icon": "P",
249
- "spawn_prompt": "You are the CSS & Design System Specialist. Validate Tailwind CSS follows design system tokens (no off-palette colors), review component styling with shadcn/ui conventions. Ensure no inline styles with hardcoded values. Run design-system, css, contrast validators."
250
- }
251
- },
252
-
253
- "testing-specialist": {
254
- "tier": 3,
255
- "role": "specialist",
256
- "title": "Testing Specialist",
257
- "domains": ["quality-testing"],
258
- "keywords": ["test", "testing", "unit", "integration", "e2e", "xunit", "vitest", "testing library", "playwright"],
259
- "always_active": false,
260
- "validators": ["architecture"],
261
- "relationships": {
262
- "reports_to": "standards-architect",
263
- "coordinates": [],
264
- "escalates_to": "standards-architect",
265
- "collaborates_with": ["dotnet-senior", "nextjs-expert"],
266
- "team_role": "specialist"
267
- },
268
- "standards": ["coding.md"],
269
- "teammate": {
270
- "role": "Testing Specialist",
271
- "icon": "Q",
272
- "spawn_prompt": "You are the Testing Specialist. Write .NET unit tests (xUnit, Moq/NSubstitute, FluentAssertions), .NET integration tests. Write frontend tests with Vitest + Testing Library. E2E with Playwright. Follow Arrange-Act-Assert (AAA) pattern."
273
- }
274
- },
275
-
276
- "_comment_tier_4": "=== TIER 4: VALIDATORS (1) ===",
277
-
278
- "security-expert": {
279
- "tier": 4,
280
- "role": "validator",
281
- "title": "Security Validator",
282
- "domains": ["security"],
283
- "keywords": ["sql injection", "xss", "rls", "secrets", "security scan", "vulnerability", "csrf", "owasp", "jwt"],
284
- "always_active": true,
285
- "validators": ["architecture"],
286
- "relationships": {
287
- "reports_to": "standards-architect",
288
- "coordinates": [],
289
- "runs_in": "hooks",
290
- "hook_triggers": ["TeammateIdle", "TaskCompleted"],
291
- "team_role": "validator"
292
- },
293
- "standards": ["coding.md", "supabase-auth.md", "supabase-rls.md"],
294
- "teammate": null,
295
- "hook_behavior": {
296
- "validates": [
297
- "SQL injection (string concatenation in Dapper queries)",
298
- "Hardcoded secrets (API keys, Supabase keys in client code)",
299
- "XSS (dangerouslySetInnerHTML in React)",
300
- "RLS bypass (missing or permissive RLS policies)",
301
- "JWT validation (Supabase JWT not verified in API)"
302
- ],
303
- "severity": "error",
304
- "blocks_on_fail": true
305
- }
306
- }
307
- },
308
-
309
- "squads": {
310
- "backend_squad": {
311
- "leader": "dotnet-senior",
312
- "members": ["api-designer", "supabase-expert"],
313
- "domains": ["backend", "backend-api", "platform-supabase"]
314
- },
315
- "frontend_squad": {
316
- "leader": "ui-ux-designer",
317
- "members": ["nextjs-expert", "css-specialist"],
318
- "domains": ["frontend-design", "frontend-nextjs", "frontend-css"],
319
- "active_phases": {
320
- "design": ["ui-ux-designer"],
321
- "implement": ["nextjs-expert", "css-specialist"]
322
- }
323
- },
324
- "infrastructure_squad": {
325
- "leader": "container-specialist",
326
- "members": ["easypanel-deployer", "devops-engineer"],
327
- "domains": ["infrastructure-containers", "infrastructure-deploy", "infrastructure-cicd"]
328
- },
329
- "quality_squad": {
330
- "leader": "standards-architect",
331
- "members": ["testing-specialist", "security-expert"],
332
- "domains": ["quality-testing", "security"],
333
- "note": "No permanent leader -- standards-architect coordinates directly"
334
- }
335
- },
336
-
337
- "relationship_types": {
338
- "reports_to": "Hierarchical manager relationship",
339
- "coordinates": "Manages/leads these agents",
340
- "escalates_to": "Where to escalate unresolved issues",
341
- "collaborates_with": "Peer agents for cross-domain work",
342
- "runs_in": "Execution context (hooks, not teammates)",
343
- "team_role": "Role in Agent Teams (lead, domain_leader, specialist, validator)"
344
- }
345
- }
1
+ {
2
+ "$schema": "./agent-schema.json",
3
+ "version": "3.0.0-hierarchical",
4
+ "stack": "nextjs-supabase",
5
+ "total_agents": 12,
6
+ "tiers": {
7
+ "tier_1_orchestrators": 1,
8
+ "tier_2_leaders": 2,
9
+ "tier_3_specialists": 8,
10
+ "tier_4_validators": 1
11
+ },
12
+
13
+ "agents": {
14
+
15
+ "_comment_tier_1": "=== TIER 1: ORCHESTRATORS (1) ===",
16
+
17
+ "standards-architect": {
18
+ "tier": 1,
19
+ "role": "orchestrator",
20
+ "title": "Chief Architect",
21
+ "domains": ["architecture", "developer-experience"],
22
+ "keywords": [],
23
+ "always_active": true,
24
+ "validators": ["architecture", "packages"],
25
+ "relationships": {
26
+ "reports_to": "user",
27
+ "coordinates": ["dotnet-senior", "supabase-expert", "nextjs-expert", "testing-specialist", "ui-ux-designer"],
28
+ "escalates_to": "user",
29
+ "team_role": "lead"
30
+ },
31
+ "standards": ["coding.md", "architecture.md", "nextjs-patterns.md", "supabase-auth.md", "supabase-rls.md"],
32
+ "teammate": {
33
+ "role": "Team Lead (Delegate Mode)",
34
+ "icon": "T",
35
+ "spawn_prompt": "You are the Chief Architect and Team Lead in delegate mode. Coordinate specialists, resolve conflicts, synthesize results. DO NOT implement code yourself. Escalate conflicts to user when teammates disagree on architecture/tech choices."
36
+ }
37
+ },
38
+
39
+ "_comment_tier_2": "=== TIER 2: DOMAIN LEADERS (2) ===",
40
+
41
+ "dotnet-senior": {
42
+ "tier": 2,
43
+ "role": "domain-leader",
44
+ "title": "Backend Squad Leader",
45
+ "domains": ["backend"],
46
+ "keywords": ["backend", "api", "dotnet", ".net", "csharp", "c#", "minimal api", "endpoint", "dapper", "npgsql"],
47
+ "always_active": true,
48
+ "validators": ["architecture", "packages"],
49
+ "relationships": {
50
+ "reports_to": "standards-architect",
51
+ "coordinates": ["api-designer", "testing-specialist"],
52
+ "escalates_to": "standards-architect",
53
+ "collaborates_with": ["supabase-expert", "nextjs-expert", "container-specialist"],
54
+ "team_role": "domain_leader"
55
+ },
56
+ "standards": ["coding.md", "architecture.md"],
57
+ "teammate": {
58
+ "role": "Backend Squad Leader",
59
+ "icon": "B",
60
+ "spawn_prompt": "You are the Backend Squad Leader. .NET 10 Minimal API with Npgsql + Dapper (NOT EF Core). Coordinate backend specialists. Validate Supabase JWT tokens in API middleware. Assign tasks, review designs, enforce backend standards. Escalate cross-domain conflicts to standards-architect."
61
+ }
62
+ },
63
+
64
+ "ui-ux-designer": {
65
+ "tier": 2,
66
+ "role": "domain-leader",
67
+ "title": "UI/UX Squad Leader",
68
+ "domains": ["frontend-design"],
69
+ "keywords": ["wireframe", "mockup", "user flow", "ux", "design", "interface design", "user experience", "page", "dashboard", "form", "UI", "screen", "panel"],
70
+ "always_active": false,
71
+ "validators": ["design-system", "contrast"],
72
+ "relationships": {
73
+ "reports_to": "standards-architect",
74
+ "coordinates": ["nextjs-expert", "css-specialist"],
75
+ "escalates_to": "standards-architect",
76
+ "collaborates_with": ["dotnet-senior"],
77
+ "team_role": "domain_leader",
78
+ "active_phases": ["uiux"]
79
+ },
80
+ "standards": ["css-naming.md", "nextjs-patterns.md"],
81
+ "teammate": {
82
+ "role": "UI/UX Squad Leader",
83
+ "icon": "U",
84
+ "spawn_prompt": "You are the UI/UX Squad Leader. Create wireframes, mockups, user flows. Define design system (colors, typography, spacing) using Tailwind CSS tokens. Coordinate with nextjs-expert and css-specialist for implementation. Work is AGNOSTIC (no implementation code)."
85
+ }
86
+ },
87
+
88
+ "_comment_tier_3": "=== TIER 3: SPECIALISTS (8) ===",
89
+
90
+ "nextjs-expert": {
91
+ "tier": 3,
92
+ "role": "specialist",
93
+ "title": "Next.js Development Specialist",
94
+ "domains": ["frontend-nextjs"],
95
+ "keywords": ["nextjs", "next.js", "react", "frontend", "shadcn", "server components", "server actions", "app router", "tanstack"],
96
+ "always_active": false,
97
+ "validators": ["packages", "css", "design-system"],
98
+ "relationships": {
99
+ "reports_to": "ui-ux-designer",
100
+ "coordinates": [],
101
+ "escalates_to": "standards-architect",
102
+ "collaborates_with": ["api-designer", "css-specialist", "supabase-expert"],
103
+ "team_role": "specialist",
104
+ "active_phases": ["uiux", "implement"]
105
+ },
106
+ "standards": ["coding.md", "nextjs-patterns.md"],
107
+ "teammate": {
108
+ "role": "Next.js Development Specialist",
109
+ "icon": "N",
110
+ "spawn_prompt": "You are the Next.js 15 Development Specialist. Build App Router pages with shadcn/ui components. Use @supabase/ssr for auth (NOT Clerk). Implement Server Components, Server Actions, Route Handlers. Use TanStack Query for client-side data fetching. Message api-designer for backend endpoints."
111
+ }
112
+ },
113
+
114
+ "api-designer": {
115
+ "tier": 3,
116
+ "role": "specialist",
117
+ "title": "API Design Specialist",
118
+ "domains": ["backend-api"],
119
+ "keywords": ["rest", "api", "openapi", "swagger", "endpoint", "minimal api", "route", "versioning", "rate limiting"],
120
+ "always_active": false,
121
+ "validators": ["architecture"],
122
+ "relationships": {
123
+ "reports_to": "dotnet-senior",
124
+ "coordinates": [],
125
+ "escalates_to": "dotnet-senior",
126
+ "collaborates_with": ["supabase-expert", "nextjs-expert"],
127
+ "team_role": "specialist"
128
+ },
129
+ "standards": ["coding.md", "architecture.md"],
130
+ "teammate": {
131
+ "role": "API Design Specialist",
132
+ "icon": "A",
133
+ "spawn_prompt": "You are the API Design Specialist. Design REST APIs using .NET 10 Minimal API (MapGet, MapPost, etc.). Use endpoint groups, typed results, OpenAPI annotations. Implement API versioning, rate limiting. Validate Supabase JWT in middleware."
134
+ }
135
+ },
136
+
137
+ "supabase-expert": {
138
+ "tier": 3,
139
+ "role": "specialist",
140
+ "title": "Supabase Platform Specialist",
141
+ "domains": ["platform-supabase"],
142
+ "keywords": ["supabase", "postgres", "postgresql", "rls", "row level security", "auth", "storage", "realtime", "pgvector", "migration", "backend/database/postgresql/database", "policy"],
143
+ "always_active": true,
144
+ "validators": ["architecture"],
145
+ "relationships": {
146
+ "reports_to": "standards-architect",
147
+ "coordinates": [],
148
+ "escalates_to": "standards-architect",
149
+ "collaborates_with": ["dotnet-senior", "nextjs-expert", "security-expert"],
150
+ "team_role": "specialist"
151
+ },
152
+ "standards": ["supabase-auth.md", "supabase-rls.md", "supabase-storage.md", "supabase-pgvector.md"],
153
+ "teammate": {
154
+ "role": "Supabase Platform Specialist",
155
+ "icon": "S",
156
+ "spawn_prompt": "You are the Supabase Platform Specialist. Design PostgreSQL schemas (snake_case), write SQL migrations, create RLS policies for multi-tenant security. Configure Supabase Auth (Google + GitHub OAuth), Storage buckets with policies, Realtime subscriptions. Implement pgvector for vector search when needed. Collaborate with security-expert for RLS audit."
157
+ }
158
+ },
159
+
160
+ "easypanel-deployer": {
161
+ "tier": 3,
162
+ "role": "specialist",
163
+ "title": "EasyPanel Deployment Specialist",
164
+ "domains": ["infrastructure-deploy"],
165
+ "keywords": ["easypanel", "deploy", "deployment", "hosting", "ssl", "domain", "vps", "production"],
166
+ "always_active": false,
167
+ "validators": ["architecture"],
168
+ "relationships": {
169
+ "reports_to": "standards-architect",
170
+ "coordinates": [],
171
+ "escalates_to": "standards-architect",
172
+ "collaborates_with": ["container-specialist", "devops-engineer"],
173
+ "team_role": "specialist"
174
+ },
175
+ "standards": ["easypanel-deploy.md"],
176
+ "teammate": {
177
+ "role": "EasyPanel Deployment Specialist",
178
+ "icon": "E",
179
+ "spawn_prompt": "You are the EasyPanel Deployment Specialist. Configure EasyPanel services (API + Web), set up GitHub integration for auto-deploy, manage SSL certificates and custom domains. Define environment variables, health check endpoints, resource limits."
180
+ }
181
+ },
182
+
183
+ "container-specialist": {
184
+ "tier": 3,
185
+ "role": "specialist",
186
+ "title": "Containerization Specialist",
187
+ "domains": ["infrastructure-containers"],
188
+ "keywords": ["docker", "container", "dockerfile", "multi-stage", "docker compose", "health check", "image"],
189
+ "always_active": true,
190
+ "validators": ["architecture"],
191
+ "relationships": {
192
+ "reports_to": "standards-architect",
193
+ "coordinates": [],
194
+ "escalates_to": "standards-architect",
195
+ "collaborates_with": ["easypanel-deployer", "devops-engineer", "dotnet-senior", "nextjs-expert"],
196
+ "team_role": "specialist"
197
+ },
198
+ "standards": ["easypanel-deploy.md"],
199
+ "teammate": {
200
+ "role": "Containerization Specialist",
201
+ "icon": "D",
202
+ "spawn_prompt": "You are the Containerization Specialist for EasyPanel deployments. Write multi-stage Dockerfiles (.NET API + Next.js), docker-compose.yml for local dev, .dockerignore files. Optimize image sizes, configure health checks (/health endpoint). Target EasyPanel container service format."
203
+ }
204
+ },
205
+
206
+ "devops-engineer": {
207
+ "tier": 3,
208
+ "role": "specialist",
209
+ "title": "CI/CD Specialist",
210
+ "domains": ["infrastructure-cicd"],
211
+ "keywords": ["pipeline", "ci/cd", "github actions", "auto-deploy", "workflow", "continuous integration"],
212
+ "always_active": false,
213
+ "validators": ["architecture"],
214
+ "relationships": {
215
+ "reports_to": "standards-architect",
216
+ "coordinates": [],
217
+ "escalates_to": "standards-architect",
218
+ "collaborates_with": ["container-specialist", "easypanel-deployer"],
219
+ "team_role": "specialist"
220
+ },
221
+ "standards": ["easypanel-deploy.md"],
222
+ "teammate": {
223
+ "role": "CI/CD Specialist",
224
+ "icon": "C",
225
+ "spawn_prompt": "You are the CI/CD Specialist. Build GitHub Actions workflows for .NET build/test + Next.js build/test. Configure auto-deploy to EasyPanel via GitHub webhook or API. Implement environment-based deployments (staging, production)."
226
+ }
227
+ },
228
+
229
+ "css-specialist": {
230
+ "tier": 3,
231
+ "role": "specialist",
232
+ "title": "CSS & Design System Specialist",
233
+ "domains": ["frontend-css"],
234
+ "keywords": ["css", "tailwind", "design system", "styling", "theme", "design tokens", "shadcn"],
235
+ "always_active": false,
236
+ "validators": ["css", "contrast", "design-system"],
237
+ "relationships": {
238
+ "reports_to": "ui-ux-designer",
239
+ "coordinates": [],
240
+ "escalates_to": "ui-ux-designer",
241
+ "collaborates_with": ["nextjs-expert"],
242
+ "team_role": "specialist",
243
+ "active_phases": ["implement"]
244
+ },
245
+ "standards": ["css-naming.md", "nextjs-patterns.md"],
246
+ "teammate": {
247
+ "role": "CSS & Design System Specialist",
248
+ "icon": "P",
249
+ "spawn_prompt": "You are the CSS & Design System Specialist. Validate Tailwind CSS follows design system tokens (no off-palette colors), review component styling with shadcn/ui conventions. Ensure no inline styles with hardcoded values. Run design-system, css, contrast validators."
250
+ }
251
+ },
252
+
253
+ "testing-specialist": {
254
+ "tier": 3,
255
+ "role": "specialist",
256
+ "title": "Testing Specialist",
257
+ "domains": ["quality-testing"],
258
+ "keywords": ["test", "testing", "unit", "integration", "e2e", "xunit", "vitest", "testing library", "playwright"],
259
+ "always_active": false,
260
+ "validators": ["architecture"],
261
+ "relationships": {
262
+ "reports_to": "standards-architect",
263
+ "coordinates": [],
264
+ "escalates_to": "standards-architect",
265
+ "collaborates_with": ["dotnet-senior", "nextjs-expert"],
266
+ "team_role": "specialist"
267
+ },
268
+ "standards": ["coding.md"],
269
+ "teammate": {
270
+ "role": "Testing Specialist",
271
+ "icon": "Q",
272
+ "spawn_prompt": "You are the Testing Specialist. Write .NET unit tests (xUnit, Moq/NSubstitute, FluentAssertions), .NET integration tests. Write frontend tests with Vitest + Testing Library. E2E with Playwright. Follow Arrange-Act-Assert (AAA) pattern."
273
+ }
274
+ },
275
+
276
+ "_comment_tier_4": "=== TIER 4: VALIDATORS (1) ===",
277
+
278
+ "security-expert": {
279
+ "tier": 4,
280
+ "role": "validator",
281
+ "title": "Security Validator",
282
+ "domains": ["security"],
283
+ "keywords": ["sql injection", "xss", "rls", "secrets", "security scan", "vulnerability", "csrf", "owasp", "jwt"],
284
+ "always_active": true,
285
+ "validators": ["architecture"],
286
+ "relationships": {
287
+ "reports_to": "standards-architect",
288
+ "coordinates": [],
289
+ "runs_in": "hooks",
290
+ "hook_triggers": ["TeammateIdle", "TaskCompleted"],
291
+ "team_role": "validator"
292
+ },
293
+ "standards": ["coding.md", "supabase-auth.md", "supabase-rls.md"],
294
+ "teammate": null,
295
+ "hook_behavior": {
296
+ "validates": [
297
+ "SQL injection (string concatenation in Dapper queries)",
298
+ "Hardcoded secrets (API keys, Supabase keys in client code)",
299
+ "XSS (dangerouslySetInnerHTML in React)",
300
+ "RLS bypass (missing or permissive RLS policies)",
301
+ "JWT validation (Supabase JWT not verified in API)"
302
+ ],
303
+ "severity": "error",
304
+ "blocks_on_fail": true
305
+ }
306
+ }
307
+ },
308
+
309
+ "squads": {
310
+ "backend_squad": {
311
+ "leader": "dotnet-senior",
312
+ "members": ["api-designer", "supabase-expert"],
313
+ "domains": ["backend", "backend-api", "platform-supabase"]
314
+ },
315
+ "frontend_squad": {
316
+ "leader": "ui-ux-designer",
317
+ "members": ["nextjs-expert", "css-specialist"],
318
+ "domains": ["frontend-design", "frontend-nextjs", "frontend-css"],
319
+ "active_phases": {
320
+ "design": ["ui-ux-designer"],
321
+ "implement": ["nextjs-expert", "css-specialist"]
322
+ }
323
+ },
324
+ "infrastructure_squad": {
325
+ "leader": "container-specialist",
326
+ "members": ["easypanel-deployer", "devops-engineer"],
327
+ "domains": ["infrastructure-containers", "infrastructure-deploy", "infrastructure-cicd"]
328
+ },
329
+ "quality_squad": {
330
+ "leader": "standards-architect",
331
+ "members": ["testing-specialist", "security-expert"],
332
+ "domains": ["quality-testing", "security"],
333
+ "note": "No permanent leader -- standards-architect coordinates directly"
334
+ }
335
+ },
336
+
337
+ "relationship_types": {
338
+ "reports_to": "Hierarchical manager relationship",
339
+ "coordinates": "Manages/leads these agents",
340
+ "escalates_to": "Where to escalate unresolved issues",
341
+ "collaborates_with": "Peer agents for cross-domain work",
342
+ "runs_in": "Execution context (hooks, not teammates)",
343
+ "team_role": "Role in Agent Teams (lead, domain_leader, specialist, validator)"
344
+ }
345
+ }