sinapse-ai 1.7.0 → 1.9.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 (368) hide show
  1. package/.claude/CLAUDE.md +5 -11
  2. package/.claude/hooks/README.md +14 -1
  3. package/.claude/hooks/code-intel-pretool.cjs +115 -0
  4. package/.claude/hooks/enforce-delegation.cjs +31 -3
  5. package/.claude/hooks/enforce-framework-boundary.cjs +324 -0
  6. package/.claude/hooks/enforce-permission-mode.cjs +249 -0
  7. package/.claude/hooks/mind-clone-governance.py +212 -212
  8. package/.claude/hooks/read-protection.py +152 -152
  9. package/.claude/hooks/secret-scanning.cjs +34 -43
  10. package/.claude/hooks/slug-validation.py +175 -175
  11. package/.claude/hooks/sql-governance.py +183 -183
  12. package/.claude/hooks/synapse-engine.cjs +23 -23
  13. package/.claude/hooks/telemetry-post-tool.cjs +128 -0
  14. package/.claude/hooks/telemetry-stop.cjs +132 -0
  15. package/.claude/hooks/verify-packages.cjs +9 -2
  16. package/.claude/rules/documentation-first.md +1 -1
  17. package/.claude/rules/hook-governance.md +3 -1
  18. package/.claude/rules/project-intelligence.md +1 -1
  19. package/.codex/agents/analyst.md +4 -371
  20. package/.codex/agents/animations-orqx.md +4 -57
  21. package/.codex/agents/architect.md +4 -560
  22. package/.codex/agents/brand-orqx.md +4 -95
  23. package/.codex/agents/claude-mastery-chief.md +4 -0
  24. package/.codex/agents/cloning-orqx.md +4 -70
  25. package/.codex/agents/commercial-orqx.md +4 -67
  26. package/.codex/agents/config-engineer.md +2 -2
  27. package/.codex/agents/content-orqx.md +4 -77
  28. package/.codex/agents/copy-orqx.md +4 -65
  29. package/.codex/agents/cost-optimizer.md +4 -0
  30. package/.codex/agents/council-orqx.md +4 -68
  31. package/.codex/agents/courses-orqx.md +4 -64
  32. package/.codex/agents/cro-persuasion.md +4 -0
  33. package/.codex/agents/cyber-orqx.md +4 -67
  34. package/.codex/agents/data-engineer.md +4 -542
  35. package/.codex/agents/design-orqx.md +4 -65
  36. package/.codex/agents/design-system.md +4 -210
  37. package/.codex/agents/developer.md +4 -666
  38. package/.codex/agents/devops.md +4 -668
  39. package/.codex/agents/finance-orqx.md +4 -57
  40. package/.codex/agents/fiscal-compliance-br.md +4 -0
  41. package/.codex/agents/forecast-strategist.md +4 -0
  42. package/.codex/agents/growth-orqx.md +4 -75
  43. package/.codex/agents/hooks-architect.md +2 -2
  44. package/.codex/agents/mcp-integrator.md +2 -2
  45. package/.codex/agents/paidmedia-orqx.md +4 -67
  46. package/.codex/agents/platform-aesthetic-director.md +4 -0
  47. package/.codex/agents/premium-packaging-strategist.md +4 -0
  48. package/.codex/agents/product-lead.md +4 -371
  49. package/.codex/agents/product-orqx.md +4 -57
  50. package/.codex/agents/product-surface-director.md +4 -0
  51. package/.codex/agents/project-integrator.md +2 -2
  52. package/.codex/agents/project-lead.md +4 -414
  53. package/.codex/agents/quality-gate.md +4 -547
  54. package/.codex/agents/research-orqx.md +4 -67
  55. package/.codex/agents/roadmap-sentinel.md +2 -2
  56. package/.codex/agents/skill-craftsman.md +2 -2
  57. package/.codex/agents/snps-orqx.md +4 -684
  58. package/.codex/agents/sop-extractor.md +4 -61
  59. package/.codex/agents/sprint-lead.md +4 -324
  60. package/.codex/agents/squad-creator.md +4 -402
  61. package/.codex/agents/storytelling-orqx.md +4 -65
  62. package/.codex/agents/swarm-orqx.md +4 -64
  63. package/.codex/agents/ux-design-expert.md +4 -532
  64. package/.codex/agents/ux-designer.md +4 -124
  65. package/.codex/command-registry.json +9 -9
  66. package/.codex/delegation-matrix.json +373 -838
  67. package/.codex/delegation-parity.json +657 -0
  68. package/.codex/handoff-packet.parity.schema.json +148 -0
  69. package/.codex/handoff-packet.template.json +26 -0
  70. package/.codex/instructions.md +6 -6
  71. package/.codex/scripts/resolve-codex-agent.js +482 -0
  72. package/.codex/scripts/resolve-codex-command.js +75 -12
  73. package/.codex/scripts/resolve-codex-delegation.js +131 -92
  74. package/.codex/skills/sinapse-claude/SKILL.md +3 -3
  75. package/.codex/skills/sinapse-po/SKILL.md +1 -1
  76. package/.codex/tasks/resolve-sinapse-conflict.md +1 -1
  77. package/.sinapse-ai/cli/commands/health/index.js +24 -0
  78. package/.sinapse-ai/constitution.md +5 -5
  79. package/.sinapse-ai/core/README.md +11 -0
  80. package/.sinapse-ai/core/config/config-loader.js +19 -0
  81. package/.sinapse-ai/core/doctor/checks/git-hooks.js +97 -19
  82. package/.sinapse-ai/core/events/dashboard-emitter.js +30 -9
  83. package/.sinapse-ai/core/execution/build-orchestrator.js +4 -1
  84. package/.sinapse-ai/core/execution/parallel-executor.js +7 -1
  85. package/.sinapse-ai/core/execution/subagent-dispatcher.js +126 -28
  86. package/.sinapse-ai/core/execution/wave-executor.js +4 -1
  87. package/.sinapse-ai/core/grounding/README.md +71 -11
  88. package/.sinapse-ai/core/health-check/checks/project/framework-config.js +38 -2
  89. package/.sinapse-ai/core/health-check/checks/project/package-json.js +47 -3
  90. package/.sinapse-ai/core/health-check/checks/services/gemini-cli.js +117 -0
  91. package/.sinapse-ai/core/health-check/checks/services/index.js +2 -0
  92. package/.sinapse-ai/core/health-check/healers/index.js +40 -3
  93. package/.sinapse-ai/core/ideation/ideation-engine.js +170 -121
  94. package/.sinapse-ai/core/ids/gate-evaluator.js +318 -0
  95. package/.sinapse-ai/core/ids/gates/g5-semantic-handshake.js +190 -0
  96. package/.sinapse-ai/core/ids/gates/g6-ci-integrity.js +162 -0
  97. package/.sinapse-ai/core/ids/index.js +30 -0
  98. package/.sinapse-ai/core/memory/__tests__/active-modules.verify.js +11 -0
  99. package/.sinapse-ai/core/orchestration/agent-invoker.js +29 -6
  100. package/.sinapse-ai/core/orchestration/brownfield-handler.js +36 -3
  101. package/.sinapse-ai/core/orchestration/executors/epic-3-executor.js +76 -5
  102. package/.sinapse-ai/core/orchestration/executors/epic-4-executor.js +63 -17
  103. package/.sinapse-ai/core/orchestration/executors/epic-6-executor.js +153 -41
  104. package/.sinapse-ai/core/orchestration/executors/epic-executor.js +40 -0
  105. package/.sinapse-ai/core/orchestration/greenfield-handler.js +87 -3
  106. package/.sinapse-ai/core/orchestration/master-orchestrator.js +105 -7
  107. package/.sinapse-ai/core/orchestration/parallel-executor.js +6 -1
  108. package/.sinapse-ai/core/orchestration/workflow-executor.js +41 -0
  109. package/.sinapse-ai/core/registry/squad-agent-resolver.js +253 -0
  110. package/.sinapse-ai/core/telemetry/ids-sink.js +188 -0
  111. package/.sinapse-ai/core/ui/observability-panel.js +240 -0
  112. package/.sinapse-ai/core/utils/output-formatter.js +8 -290
  113. package/.sinapse-ai/core-config.yaml +29 -1
  114. package/.sinapse-ai/data/entity-registry.yaml +15056 -13761
  115. package/.sinapse-ai/development/agents/developer.md +2 -0
  116. package/.sinapse-ai/development/agents/devops.md +9 -0
  117. package/.sinapse-ai/development/agents/snps-orqx.md +12 -22
  118. package/.sinapse-ai/development/external-executors/README.md +18 -0
  119. package/.sinapse-ai/development/external-executors/codex.md +56 -0
  120. package/.sinapse-ai/development/scripts/populate-entity-registry.js +65 -9
  121. package/.sinapse-ai/development/scripts/squad/squad-downloader.js +54 -11
  122. package/.sinapse-ai/development/tasks/build-autonomous.md +11 -1
  123. package/.sinapse-ai/development/tasks/build-resume.md +8 -0
  124. package/.sinapse-ai/development/tasks/build-status.md +8 -0
  125. package/.sinapse-ai/development/tasks/build.md +8 -0
  126. package/.sinapse-ai/development/tasks/cleanup-worktrees.md +8 -1
  127. package/.sinapse-ai/development/tasks/delegate-to-external-executor.md +152 -0
  128. package/.sinapse-ai/development/tasks/github-devops-pre-push-quality-gate.md +46 -29
  129. package/.sinapse-ai/development/tasks/gotcha.md +8 -0
  130. package/.sinapse-ai/development/tasks/gotchas.md +8 -0
  131. package/.sinapse-ai/development/tasks/ids-health.md +14 -6
  132. package/.sinapse-ai/development/tasks/list-mcps.md +15 -0
  133. package/.sinapse-ai/development/tasks/merge-worktree.md +8 -1
  134. package/.sinapse-ai/development/tasks/qa-review-build.md +18 -0
  135. package/.sinapse-ai/development/tasks/remove-mcp.md +8 -1
  136. package/.sinapse-ai/development/tasks/update-sinapse.md +3 -3
  137. package/.sinapse-ai/development/tasks/validate-agents.md +26 -14
  138. package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
  139. package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
  140. package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
  141. package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
  142. package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
  143. package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
  144. package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
  145. package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
  146. package/.sinapse-ai/git-hooks/lib/framework-guard.js +258 -0
  147. package/.sinapse-ai/git-hooks/lib/secret-scanner-core.js +283 -0
  148. package/.sinapse-ai/git-hooks/lib/staged-secret-scan.js +179 -0
  149. package/.sinapse-ai/git-hooks/lib/staged-sql-guard.js +204 -0
  150. package/.sinapse-ai/git-hooks/post-commit +28 -0
  151. package/.sinapse-ai/git-hooks/pre-commit +81 -0
  152. package/.sinapse-ai/git-hooks/pre-push +77 -0
  153. package/.sinapse-ai/hooks/ids-post-commit.js +13 -11
  154. package/.sinapse-ai/hooks/ids-pre-push.js +9 -7
  155. package/.sinapse-ai/hooks/sinapse-brand-grounding.cjs +4 -7
  156. package/.sinapse-ai/hooks/sinapse-ds-grounding.cjs +4 -7
  157. package/.sinapse-ai/hooks/sinapse-vault-grounding.cjs +4 -7
  158. package/.sinapse-ai/infrastructure/integrations/ai-providers/ai-provider-factory.js +4 -1
  159. package/.sinapse-ai/infrastructure/integrations/ai-providers/claude-provider.js +57 -55
  160. package/.sinapse-ai/infrastructure/scripts/codex-parity/resolve.js +161 -0
  161. package/.sinapse-ai/infrastructure/scripts/dashboard-status-writer.js +6 -2
  162. package/.sinapse-ai/infrastructure/scripts/ide-sync/index.js +139 -21
  163. package/.sinapse-ai/infrastructure/scripts/ide-sync/persona-renderer.js +97 -0
  164. package/.sinapse-ai/infrastructure/scripts/sync-codex-local-first.js +156 -1
  165. package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +1 -4
  166. package/.sinapse-ai/infrastructure/scripts/validate-codex-integration.js +41 -5
  167. package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
  168. package/.sinapse-ai/infrastructure/templates/config/env.example +16 -16
  169. package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -59
  170. package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -12
  171. package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
  172. package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
  173. package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
  174. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
  175. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
  176. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
  177. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
  178. package/.sinapse-ai/infrastructure/templates/safe-collab/CODEOWNERS.template +16 -16
  179. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
  180. package/.sinapse-ai/install-manifest.yaml +239 -223
  181. package/.sinapse-ai/local-config.yaml.template +65 -65
  182. package/.sinapse-ai/product/templates/adr.hbs +126 -126
  183. package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
  184. package/.sinapse-ai/product/templates/epic.hbs +213 -213
  185. package/.sinapse-ai/product/templates/ide-rules/codex-rules.md +30 -0
  186. package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
  187. package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
  188. package/.sinapse-ai/product/templates/prd.hbs +202 -202
  189. package/.sinapse-ai/product/templates/statusline/statusline-script.js +31 -8
  190. package/.sinapse-ai/product/templates/statusline/track-agent-clear.cjs +79 -0
  191. package/.sinapse-ai/product/templates/statusline/track-agent.cjs +218 -0
  192. package/.sinapse-ai/product/templates/story.hbs +264 -264
  193. package/.sinapse-ai/product/templates/task.hbs +171 -171
  194. package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
  195. package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
  196. package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
  197. package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
  198. package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
  199. package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
  200. package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
  201. package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
  202. package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
  203. package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
  204. package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
  205. package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
  206. package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
  207. package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
  208. package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
  209. package/.sinapse-ai/scripts/pm.sh +18 -6
  210. package/AGENTS.md +193 -0
  211. package/LICENSE +63 -63
  212. package/README.en.md +17 -18
  213. package/README.md +18 -19
  214. package/bin/cli.js +18 -1
  215. package/bin/commands/agents.js +96 -0
  216. package/bin/commands/doctor.js +15 -0
  217. package/bin/commands/ideate.js +129 -0
  218. package/bin/commands/install.js +194 -22
  219. package/bin/commands/status.js +14 -1
  220. package/bin/commands/uninstall.js +40 -0
  221. package/bin/commands/update.js +52 -0
  222. package/bin/lib/setup-statusline.js +191 -0
  223. package/bin/postinstall.js +50 -4
  224. package/bin/sinapse-init.js +11 -83
  225. package/bin/sinapse.js +146 -2
  226. package/bin/utils/framework-guard.js +17 -4
  227. package/bin/utils/secret-scanner-core.js +283 -0
  228. package/bin/utils/staged-secret-scan.js +106 -40
  229. package/bin/utils/staged-sql-guard.js +204 -0
  230. package/bin/utils/validate-publish.js +63 -0
  231. package/docs/agent-reference-guide.md +4 -6
  232. package/docs/framework/agent-prefix-convention.md +58 -0
  233. package/docs/framework/collaboration-activation.md +45 -0
  234. package/docs/security/overview.md +1 -1
  235. package/package.json +16 -8
  236. package/packages/installer/src/index.js +26 -0
  237. package/packages/installer/src/installer/git-hooks-installer.js +546 -0
  238. package/packages/installer/src/installer/sinapse-ai-installer.js +87 -0
  239. package/packages/installer/src/wizard/feedback.js +1 -1
  240. package/packages/installer/src/wizard/ide-config-generator.js +40 -25
  241. package/packages/installer/src/wizard/index.js +50 -0
  242. package/packages/installer/src/wizard/validators.js +38 -1
  243. package/packages/installer/tests/unit/artifact-copy-pipeline/artifact-copy-pipeline.test.js +24 -1
  244. package/packages/installer/tests/unit/doctor/doctor-checks.test.js +42 -3
  245. package/packages/installer/tests/unit/entity-registry-bootstrap.test.js +10 -4
  246. package/packages/installer/tests/unit/git-hooks-installer.test.js +262 -0
  247. package/packages/sinapse-install/bin/edmcp.js +0 -0
  248. package/packages/sinapse-install/bin/sinapse-install.js +0 -0
  249. package/scripts/audit-tasks.cjs +112 -91
  250. package/scripts/check-markdown-links.py +352 -352
  251. package/scripts/eval-runner.js +422 -0
  252. package/scripts/generate-install-manifest.js +13 -9
  253. package/scripts/generate-synapse-runtime.js +51 -0
  254. package/scripts/prepare-hooks.js +58 -0
  255. package/scripts/regenerate-orqx-stubs.ps1 +2 -2
  256. package/scripts/validate-agents-md.js +128 -0
  257. package/scripts/validate-all.js +2 -0
  258. package/scripts/validate-evals.js +466 -0
  259. package/scripts/validate-schemas.js +539 -0
  260. package/scripts/validate-squad-orqx.js +9 -2
  261. package/sinapse/agents/sinapse-orqx.md +12 -22
  262. package/sinapse/agents/snps-orqx.md +11 -21
  263. package/squads/claude-code-mastery/squad.yaml +8 -0
  264. package/squads/squad-animations/squad.yaml +1 -1
  265. package/squads/squad-brand/squad.yaml +1 -1
  266. package/squads/squad-cloning/squad.yaml +1 -1
  267. package/squads/squad-commercial/squad.yaml +2 -3
  268. package/squads/squad-content/squad.yaml +1 -1
  269. package/squads/squad-copy/squad.yaml +2 -3
  270. package/squads/squad-courses/squad.yaml +1 -1
  271. package/squads/squad-cybersecurity/squad.yaml +2 -3
  272. package/squads/{squad-artdir → squad-design}/agents/cro-persuasion.md +1 -1
  273. package/squads/{squad-artdir → squad-design}/agents/platform-aesthetic-director.md +2 -2
  274. package/squads/{squad-artdir → squad-design}/agents/premium-packaging-strategist.md +2 -2
  275. package/squads/{squad-artdir → squad-design}/agents/product-surface-director.md +3 -3
  276. package/squads/squad-design/squad.yaml +6 -3
  277. package/squads/squad-finance/squad.yaml +7 -1
  278. package/squads/squad-growth/squad.yaml +1 -1
  279. package/squads/squad-paidmedia/squad.yaml +2 -3
  280. package/squads/squad-product/squad.yaml +1 -1
  281. package/squads/squad-research/squad.yaml +2 -3
  282. package/squads/squad-storytelling/squad.yaml +2 -3
  283. package/.codex/agents/brad-frost.md +0 -46
  284. package/.codex/agents/claude-orqx.md +0 -72
  285. package/.codex/agents/copy-chief.md +0 -162
  286. package/.codex/agents/cyber-chief.md +0 -169
  287. package/.codex/agents/dan-mall.md +0 -43
  288. package/.codex/agents/data-chief.md +0 -198
  289. package/.codex/agents/dave-malouf.md +0 -43
  290. package/.codex/agents/db-sage.md +0 -152
  291. package/.codex/agents/design-chief.md +0 -226
  292. package/.codex/agents/dev.md +0 -102
  293. package/.codex/agents/legal-chief.md +0 -199
  294. package/.codex/agents/nano-banana-generator.md +0 -42
  295. package/.codex/agents/pm.md +0 -81
  296. package/.codex/agents/po.md +0 -85
  297. package/.codex/agents/qa.md +0 -98
  298. package/.codex/agents/sm.md +0 -77
  299. package/.codex/agents/squad-chief.md +0 -1553
  300. package/.codex/agents/squad.md +0 -66
  301. package/.codex/agents/story-chief.md +0 -180
  302. package/.codex/agents/tools-orqx.md +0 -219
  303. package/.codex/agents/traffic-masters-chief.md +0 -211
  304. package/.sinapse-ai/data/registry-update-log.jsonl +0 -72
  305. package/.sinapse-ai/development/scripts/elicitation-engine.js +0 -385
  306. package/.sinapse-ai/development/scripts/elicitation-session-manager.js +0 -300
  307. package/.sinapse-ai/development/tasks/test-validation-task.md +0 -172
  308. package/.sinapse-ai/monitor/hooks/lib/__init__.py +0 -2
  309. package/.sinapse-ai/monitor/hooks/lib/enrich.py +0 -59
  310. package/.sinapse-ai/monitor/hooks/lib/send_event.py +0 -48
  311. package/.sinapse-ai/monitor/hooks/notification.py +0 -30
  312. package/.sinapse-ai/monitor/hooks/post_tool_use.py +0 -46
  313. package/.sinapse-ai/monitor/hooks/pre_compact.py +0 -30
  314. package/.sinapse-ai/monitor/hooks/pre_tool_use.py +0 -41
  315. package/.sinapse-ai/monitor/hooks/stop.py +0 -30
  316. package/.sinapse-ai/monitor/hooks/subagent_stop.py +0 -30
  317. package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +0 -39
  318. package/.sinapse-ai/product/templates/statusline/track-agent.sh +0 -69
  319. package/bin/sinapse-graph.js +0 -19
  320. package/docs/codex-integration-process.md +0 -22
  321. package/docs/codex-parity-program.md +0 -27
  322. package/scripts/install-monitor-hooks.sh +0 -82
  323. package/squads/squad-artdir/README.md +0 -90
  324. package/squads/squad-artdir/agents/accessibility-guardian.md +0 -184
  325. package/squads/squad-artdir/agents/artdir-orqx.md +0 -222
  326. package/squads/squad-artdir/agents/color-psychologist.md +0 -166
  327. package/squads/squad-artdir/agents/design-system-architect.md +0 -100
  328. package/squads/squad-artdir/agents/ia-architect.md +0 -169
  329. package/squads/squad-artdir/agents/interaction-designer.md +0 -162
  330. package/squads/squad-artdir/agents/layout-engineer.md +0 -163
  331. package/squads/squad-artdir/agents/motion-architect.md +0 -185
  332. package/squads/squad-artdir/agents/type-systemist.md +0 -138
  333. package/squads/squad-artdir/agents/visual-strategist.md +0 -127
  334. package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +0 -172
  335. package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +0 -289
  336. package/squads/squad-artdir/knowledge-base/deliverables-templates.md +0 -457
  337. package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +0 -247
  338. package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +0 -133
  339. package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +0 -229
  340. package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +0 -242
  341. package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +0 -289
  342. package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +0 -221
  343. package/squads/squad-artdir/package.json +0 -20
  344. package/squads/squad-artdir/squad.yaml +0 -299
  345. package/squads/squad-artdir/tasks/audit-conversion.md +0 -97
  346. package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +0 -55
  347. package/squads/squad-artdir/tasks/consult-saas-canon.md +0 -54
  348. package/squads/squad-artdir/tasks/create-art-direction-brief.md +0 -110
  349. package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +0 -61
  350. package/squads/squad-artdir/tasks/create-wireflow.md +0 -84
  351. package/squads/squad-artdir/tasks/design-color-system.md +0 -81
  352. package/squads/squad-artdir/tasks/design-product-surface.md +0 -60
  353. package/squads/squad-artdir/tasks/design-token-system.md +0 -58
  354. package/squads/squad-artdir/tasks/diagnose-visual-language.md +0 -92
  355. package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +0 -65
  356. package/squads/squad-artdir/tasks/specify-motion-system.md +0 -84
  357. package/squads/squad-artdir/tasks/validate-against-pillars.md +0 -143
  358. package/squads/squad-artdir/templates/art-direction-brief-template.md +0 -215
  359. package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +0 -142
  360. package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +0 -179
  361. package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +0 -338
  362. package/squads/squad-commercial/agents/legal-chief.md +0 -199
  363. package/squads/squad-copy/agents/copy-chief.md +0 -162
  364. package/squads/squad-cybersecurity/agents/cyber-chief.md +0 -169
  365. package/squads/squad-design/agents/design-chief.md +0 -226
  366. package/squads/squad-paidmedia/agents/traffic-masters-chief.md +0 -211
  367. package/squads/squad-research/agents/data-chief.md +0 -198
  368. package/squads/squad-storytelling/agents/story-chief.md +0 -180
@@ -1,299 +0,0 @@
1
- name: squad-artdir
2
- version: "2.0.0"
3
- description: >
4
- Art direction for retention, conversion AND platform premium packaging.
5
- v1.0 was born for landing pages. v2.0 extends the framework from 7 to 10
6
- Pillars to cover SaaS platforms, logged-in product surfaces, multi-surface
7
- design systems, and premium packaging that justifies 3x pricing. The core
8
- principle is unchanged: every pixel carries behavioral intent, every
9
- aesthetic decision is justified by a psychological principle and measured
10
- by either conversion (LP) or retention + perceived value (Platform).
11
- author: Caio Imori
12
- license: MIT
13
- slashPrefix: SINAPSE
14
-
15
- metadata:
16
- created_at: "2026-04-10"
17
- updated_at: "2026-04-12"
18
- created_by: "squad-creator (Craft)"
19
- expanded_by: "sinapse-orqx (Imperator) via EPIC-artdir-v2"
20
- agents_count: 14
21
- tasks_count: 13
22
- knowledge_bases_count: 8
23
- workflows_count: 3
24
- checklists_count: 1
25
- templates_count: 1
26
- total_files: 46
27
- agents: 14
28
- tasks: 13
29
- workflows: 0
30
- knowledge_bases: 8
31
- checklists: 1
32
- templates: 1
33
- preferences: 0
34
-
35
- agents:
36
- # ═══════════════════════════════════════════════════════════════════════════
37
- # v1.0 CORE (10 agents — LP-focused, preserved verbatim)
38
- # ═══════════════════════════════════════════════════════════════════════════
39
-
40
- - id: artdir-orqx
41
- name: Canvas
42
- file: agents/artdir-orqx.md
43
- role: "Orquestrador — coordena os 10 pilares, roteia briefings (LP vs Platform), entrega os deliverables padrao"
44
- tasks:
45
- - create-art-direction-brief
46
- - validate-against-pillars
47
-
48
- - id: visual-strategist
49
- name: Prism
50
- file: agents/visual-strategist.md
51
- role: "Define linguagem visual, mood, posicionamento estetico baseado em audiencia e categoria"
52
- tasks:
53
- - diagnose-visual-language
54
- - create-art-direction-brief
55
-
56
- - id: motion-architect
57
- name: Tempo
58
- file: agents/motion-architect.md
59
- role: "Sistema de motion — timing, easing, selecao de lib, performance, Disney 12 principles"
60
- tasks:
61
- - specify-motion-system
62
-
63
- - id: type-systemist
64
- name: Kern
65
- file: agents/type-systemist.md
66
- role: "Type scale, font pairing, tracking, hierarquia tipografica, fluid typography, custom type (premium)"
67
- tasks:
68
- - create-art-direction-brief
69
-
70
- - id: color-psychologist
71
- name: Spectrum
72
- file: agents/color-psychologist.md
73
- role: "Sistemas de cor justificados por neurociencia, WCAG AAA, Von Restorff, emotion mapping"
74
- tasks:
75
- - design-color-system
76
-
77
- - id: layout-engineer
78
- name: Grid
79
- file: agents/layout-engineer.md
80
- role: "Grids, spacing, full-bleed vs contained, responsividade, container queries"
81
- tasks:
82
- - create-wireflow
83
-
84
- - id: ia-architect
85
- name: Flow
86
- file: agents/ia-architect.md
87
- role: "Arquitetura de informacao para retencao cognitiva — disclosure, Zeigarnik, curiosity gaps"
88
- tasks:
89
- - create-wireflow
90
- - audit-conversion
91
-
92
- - id: cro-persuasion
93
- name: Convert
94
- file: agents/cro-persuasion.md
95
- role: "Padroes de conversao — comparison tables, social proof, scarcity, risk reversal, sticky bars"
96
- tasks:
97
- - audit-conversion
98
-
99
- - id: interaction-designer
100
- name: Pulse
101
- file: agents/interaction-designer.md
102
- role: "Hover states, micro-interactions, feedback loops, custom cursors, prefers-reduced-motion"
103
- tasks:
104
- - specify-motion-system
105
-
106
- - id: accessibility-guardian
107
- name: Shield
108
- file: agents/accessibility-guardian.md
109
- role: "WCAG AAA, prefers-reduced-motion, contraste, HTML semantico, keyboard nav, ARIA, focus"
110
- tasks:
111
- - validate-against-pillars
112
-
113
- # ═══════════════════════════════════════════════════════════════════════════
114
- # v2.0 EXPANSION (4 agents — Platform / SaaS / Premium Packaging)
115
- # ═══════════════════════════════════════════════════════════════════════════
116
-
117
- - id: product-surface-director
118
- name: Axiom
119
- file: agents/product-surface-director.md
120
- role: "Art direction de surfaces logadas — dashboards, empty states, data density, dark mode parity, choreographia de onboarding. Pilar 8."
121
- tasks:
122
- - design-product-surface
123
- - first-5-minutes-choreography
124
-
125
- - id: design-system-architect
126
- name: Atlas
127
- file: agents/design-system-architect.md
128
- role: "Multi-surface design system — canonical tokens, surface dialects, semver, ownership, quarterly drift audit. Pilar 9."
129
- tasks:
130
- - design-token-system
131
- - audit-drift-multi-surface
132
-
133
- - id: platform-aesthetic-director
134
- name: Vertex
135
- file: agents/platform-aesthetic-director.md
136
- role: "Custodiante do canon de SaaS premium (Linear/Vercel/Stripe/Framer/Arc/Raycast). Lens nos Pilares 8, 9, 10. Previne commodity contamination."
137
- tasks:
138
- - consult-saas-canon
139
-
140
- - id: premium-packaging-strategist
141
- name: Aura
142
- file: agents/premium-packaging-strategist.md
143
- role: "Traduz 'cobrar 3x mais' em decisoes estheticas concretas. Aplica os 5 principios nao-negociaveis. Pilar 10."
144
- tasks:
145
- - create-premium-packaging-brief
146
- - first-5-minutes-choreography
147
-
148
- # ═══════════════════════════════════════════════════════════════════════════
149
- # KNOWLEDGE BASES — v1.0 (5) + v2.0 (2) = 7
150
- # ═══════════════════════════════════════════════════════════════════════════
151
-
152
- knowledge_bases:
153
- - name: seven-pillars-framework
154
- file: knowledge-base/seven-pillars-framework.md
155
- description: "Os 7 pilares originais (v1.0) — preservado verbatim, canon LP"
156
- - name: ten-pillars-framework
157
- file: knowledge-base/ten-pillars-framework.md
158
- description: "v2.0 extension — 10 pilares com applicability matrix LP vs Platform"
159
- - name: psychological-toolkit
160
- file: knowledge-base/psychological-toolkit.md
161
- description: "Arsenal psicologico — 10 vieses cognitivos, 6 principios de retencao, 6 leis UX, 7 Gestalt"
162
- - name: case-nyo-ia-reference
163
- file: knowledge-base/case-nyo-ia-reference.md
164
- description: "Analise completa do nyo.ia.br como referencia canonica de art direction para LP de conversao"
165
- - name: saas-art-direction-canon
166
- file: knowledge-base/saas-art-direction-canon.md
167
- description: "v2.0 — Canon de 6 refs premium (Linear, Vercel, Stripe, Framer, Arc, Raycast) decomposto em 5 dimensoes"
168
- - name: premium-packaging-principles
169
- file: knowledge-base/premium-packaging-principles.md
170
- description: "v2.0 — Os 5 principios nao-negociaveis de premium packaging (council-orqx pressurization)"
171
- - name: motion-technique-catalog
172
- file: knowledge-base/motion-technique-catalog.md
173
- description: "Catalogo de tecnicas de motion com lib, easing, duracao e regras de performance"
174
- - name: deliverables-templates
175
- file: knowledge-base/deliverables-templates.md
176
- description: "Templates dos 8 deliverables padrao da squad"
177
-
178
- # ═══════════════════════════════════════════════════════════════════════════
179
- # TASKS — v1.0 (7) + v2.0 (6) = 13
180
- # ═══════════════════════════════════════════════════════════════════════════
181
-
182
- tasks:
183
- # v1.0
184
- - name: create-art-direction-brief
185
- file: tasks/create-art-direction-brief.md
186
- - name: diagnose-visual-language
187
- file: tasks/diagnose-visual-language.md
188
- - name: design-color-system
189
- file: tasks/design-color-system.md
190
- - name: specify-motion-system
191
- file: tasks/specify-motion-system.md
192
- - name: create-wireflow
193
- file: tasks/create-wireflow.md
194
- - name: audit-conversion
195
- file: tasks/audit-conversion.md
196
- - name: validate-against-pillars
197
- file: tasks/validate-against-pillars.md
198
- # v2.0
199
- - name: design-product-surface
200
- file: tasks/design-product-surface.md
201
- - name: design-token-system
202
- file: tasks/design-token-system.md
203
- - name: audit-drift-multi-surface
204
- file: tasks/audit-drift-multi-surface.md
205
- - name: create-premium-packaging-brief
206
- file: tasks/create-premium-packaging-brief.md
207
- - name: consult-saas-canon
208
- file: tasks/consult-saas-canon.md
209
- - name: first-5-minutes-choreography
210
- file: tasks/first-5-minutes-choreography.md
211
-
212
- # ═══════════════════════════════════════════════════════════════════════════
213
- # WORKFLOWS — v1.0 (2) + v2.0 (1) = 3
214
- # ═══════════════════════════════════════════════════════════════════════════
215
-
216
- workflows:
217
- - name: full-art-direction-cycle
218
- file: workflows/full-art-direction-cycle.yaml
219
- description: "v1.0 — Ciclo completo LP do briefing ao art direction brief validado contra 7 pilares"
220
- - name: conversion-audit-cycle
221
- file: workflows/conversion-audit-cycle.yaml
222
- description: "v1.0 — Auditoria de conversao de site/LP existente"
223
- - name: saas-platform-art-direction-cycle
224
- file: workflows/saas-platform-art-direction-cycle.yaml
225
- description: "v2.0 — Ciclo completo para SaaS/plataforma/produto logado aplicando os 10 Pilares (canon -> token system -> product surface -> first 5 minutes -> premium packaging -> drift audit -> validate)"
226
-
227
- checklists:
228
- - name: seven-pillars-validation-checklist
229
- file: checklists/seven-pillars-validation-checklist.md
230
-
231
- templates:
232
- - name: art-direction-brief-template
233
- file: templates/art-direction-brief-template.md
234
-
235
- # ═══════════════════════════════════════════════════════════════════════════
236
- # CROSS-SQUAD CONNECTIONS
237
- # ═══════════════════════════════════════════════════════════════════════════
238
-
239
- cross_squad_connections:
240
- inbound:
241
- - squad-brand: "Brand guidelines, identidade visual, paleta de cores, tom visual, root tokens para Atlas"
242
- - squad-research: "Pesquisa de audiencia, analise de concorrentes, benchmarks de conversao, feeds para Vertex"
243
- - squad-copy: "Copy strategy, headlines, microcopy, CTA labels"
244
- - squad-product: "PRDs, roadmap de features, personas, fluxo de uso diario para Axiom"
245
- - squad-council: "Pressurizacao estrategica (v2.0: fonte dos 5 principios de premium packaging)"
246
- - squad-finance: "Pricing power, unit economics que justificam posicionamento premium (input para Aura)"
247
- outbound:
248
- - squad-design: "Art direction brief, design tokens (DDL completo do Atlas), motion spec, wireflow anotado, component spec"
249
- - squad-animations: "Motion spec, easing curves, timing tokens, kinesthetic narrative, custom motion signatures"
250
- - squad-content: "Hierarquia visual para conteudo, pacing de leitura"
251
- - squad-growth: "CRO patterns map, hipoteses de impacto, metricas de conversao + retencao"
252
- - squad-commercial: "Pricing page art direction, premium packaging brief"
253
-
254
- # ═══════════════════════════════════════════════════════════════════════════
255
- # v2.0 CHANGELOG
256
- # ═══════════════════════════════════════════════════════════════════════════
257
-
258
- changelog:
259
- - version: "2.0.0"
260
- date: "2026-04-12"
261
- type: "major — additive expansion"
262
- epic: "EPIC-artdir-v2"
263
- summary: >
264
- Expansion from LP-only to full platform/SaaS art direction. Framework
265
- extended from 7 to 10 Pillars. 4 new specialist agents (Axiom, Atlas,
266
- Vertex, Aura). 6 new tasks. 2 new knowledge bases. 1 new workflow.
267
- v1.0 agents and pillars preserved verbatim for backward compatibility.
268
- additions:
269
- - "4 new agents: product-surface-director (Axiom), design-system-architect (Atlas), platform-aesthetic-director (Vertex), premium-packaging-strategist (Aura)"
270
- - "6 new tasks: design-product-surface, design-token-system, audit-drift-multi-surface, create-premium-packaging-brief, consult-saas-canon, first-5-minutes-choreography"
271
- - "2 new KBs: saas-art-direction-canon, premium-packaging-principles"
272
- - "1 new KB for framework: ten-pillars-framework (extends seven-pillars)"
273
- - "1 new workflow: saas-platform-art-direction-cycle"
274
- breaking_changes: []
275
- backward_compat: "Full — all v1.0 components preserved"
276
- - version: "1.0.0"
277
- date: "2026-04-10"
278
- type: "initial release"
279
- summary: "Squad created for LP art direction with 7 Pillars, 10 agents, 7 tasks, 5 KBs, 2 workflows"
280
-
281
- # ════════════════════════════════════════════════════
282
- # COMPONENTS — declared agents (synced from filesystem)
283
- # ════════════════════════════════════════════════════
284
- components:
285
- agents:
286
- - accessibility-guardian.md
287
- - artdir-orqx.md
288
- - color-psychologist.md
289
- - cro-persuasion.md
290
- - design-system-architect.md
291
- - ia-architect.md
292
- - interaction-designer.md
293
- - layout-engineer.md
294
- - motion-architect.md
295
- - platform-aesthetic-director.md
296
- - premium-packaging-strategist.md
297
- - product-surface-director.md
298
- - type-systemist.md
299
- - visual-strategist.md
@@ -1,97 +0,0 @@
1
- # Task: Audit Conversion
2
-
3
- ## Metadata
4
- - **ID:** audit-conversion
5
- - **Version:** 1.0.0
6
- - **Agent:** cro-persuasion (Convert), ia-architect (Flow) contributes
7
- - **Squad:** squad-artdir
8
-
9
- ## Description
10
-
11
- Audit an existing site or landing page against CRO patterns and suggest improvements. Produces a prioritized list of changes with impact hypotheses and effort estimates.
12
-
13
- ## Inputs
14
-
15
- | Input | Type | Required | Description |
16
- |-------|------|----------|-------------|
17
- | url | string | required | URL to audit |
18
- | objective | string | required | Primary conversion objective |
19
- | current_metrics | object | optional | Current conversion rate, bounce rate, time on page, scroll depth |
20
- | audience | string | required | Target audience description |
21
-
22
- ## Steps
23
-
24
- 1. **capture-current-state**
25
- - Fetch and analyze the URL
26
- - Screenshot key sections
27
- - Map current section sequence
28
-
29
- 2. **audit-clarity** (Score 1-10)
30
- - Is the value proposition clear in < 5 seconds?
31
- - Is the CTA visible above the fold?
32
- - Is the copy specific or generic?
33
-
34
- 3. **audit-proof** (Score 1-10)
35
- - Types of social proof present (logos, testimonials, numbers, UGC)
36
- - Specificity of proof (names, photos, results vs anonymous)
37
- - Verifiability (real handles vs generic)
38
-
39
- 4. **audit-urgency** (Score 1-10)
40
- - Is there a reason to act now?
41
- - Scarcity elements (real or perceived)
42
- - Time-bound offers
43
-
44
- 5. **audit-friction** (Score 1-10)
45
- - Number of clicks to convert
46
- - Form length and complexity
47
- - Loading speed and perceived performance
48
-
49
- 6. **audit-risk** (Score 1-10)
50
- - Are objections addressed?
51
- - Risk reversal elements (guarantees, free trial, no CC)
52
- - Trust signals (security badges, compliance)
53
-
54
- 7. **audit-accessibility** (Score 1-10)
55
- - CTA contrast and visibility
56
- - Keyboard navigation to conversion
57
- - Screen reader CTA accessibility
58
-
59
- 8. **audit-mobile** (Score 1-10)
60
- - Mobile conversion path clarity
61
- - Touch target sizes
62
- - Mobile-specific CTA visibility
63
-
64
- 9. **identify-gaps**
65
- - Cross-reference present patterns against full CRO catalog
66
- - Identify missing high-impact patterns
67
- - Identify patterns that exist but are poorly implemented
68
-
69
- 10. **prioritize-recommendations**
70
- - For each gap: estimate impact (metric + direction + magnitude)
71
- - For each gap: estimate implementation effort (low/medium/high)
72
- - Sort by impact/effort ratio
73
- - Mark quick wins (high impact, low effort)
74
-
75
- 11. **compile-audit**
76
- - Overall CRO Score (average of 7 dimensions)
77
- - Top 5 quick wins
78
- - Top 5 strategic improvements
79
- - Before/after descriptions for each recommendation
80
-
81
- ## Outputs
82
-
83
- | Output | Type | Description |
84
- |--------|------|-------------|
85
- | audit_report | document | Complete CRO audit with scores and analysis |
86
- | dimension_scores | array | Score 1-10 for each audit dimension |
87
- | recommendations | array | Prioritized list of improvements with impact estimates |
88
- | quick_wins | array | Top 5 high-impact, low-effort changes |
89
- | overall_score | number | Average of dimension scores |
90
-
91
- ## Quality Criteria
92
-
93
- - Every recommendation MUST include impact hypothesis (metric + direction + estimated %)
94
- - Every recommendation MUST include effort estimate (low/medium/high)
95
- - Missing patterns MUST be compared against the full CRO catalog
96
- - Quick wins MUST be actionable within 1 dev day
97
- - Scores MUST be justified with specific observations from the site
@@ -1,55 +0,0 @@
1
- # Task: Audit Drift (Multi-Surface Consistency Audit)
2
-
3
- ## Metadata
4
- - **ID:** audit-drift-multi-surface
5
- - **Version:** 1.0.0
6
- - **Agent:** design-system-architect (Atlas) — primary
7
- - **Supporting agents:** platform-aesthetic-director (Vertex), premium-packaging-strategist (Aura)
8
- - **Squad:** squad-artdir
9
- - **Pilar:** 9 (Multi-Surface Design System Architecture)
10
-
11
- ## Description
12
-
13
- Audit a product's deployed surfaces against the canonical token system. Detect drift. Produce remediation priorities sorted by impact on premium perception. This is the quarterly task that prevents surface degradation — the single strongest defense of pricing power.
14
-
15
- ## Inputs
16
-
17
- | Input | Type | Required | Description |
18
- |-------|------|----------|-------------|
19
- | product_url | string | required | Main product URL |
20
- | canonical_tokens | yaml | required | Reference token system (from design-token-system) |
21
- | surfaces_to_audit | array | required | List of surfaces with URLs/access methods |
22
- | audit_scope | enum | optional | full / critical-only / surface-specific |
23
-
24
- ## Steps
25
-
26
- 1. **inventory-surfaces** — list all 7 canonical surfaces and their current state (deployed / missing / partial).
27
- 2. **capture-screenshots** — screenshot each surface for visual comparison. Delegate to playwright MCP via Bash.
28
- 3. **token-diff** — for code-accessible surfaces (marketing, product), diff deployed CSS against canonical tokens.
29
- 4. **manual-audit** — for hard surfaces (email, PDF, support, mobile), manual visual audit against the canon.
30
- 5. **classify-drift** — every drift classified as: critical (visible to users on first impression) / moderate (visible on repeated use) / minor (internal inconsistency).
31
- 6. **premium-impact-score** — for each drift, score impact on premium perception (0-5).
32
- 7. **remediation-priorities** — ranked list with owner, effort estimate, and expected perception lift.
33
- 8. **handoff-to-aura** — Aura receives the audit and produces a packaging impact summary.
34
- 9. **schedule-re-audit** — calendar placeholder for next quarterly audit.
35
-
36
- ## Outputs
37
-
38
- | Output | Format | Description |
39
- |--------|--------|-------------|
40
- | drift_inventory | markdown | Full inventory with classification |
41
- | screenshots | folder | Visual evidence per surface |
42
- | remediation_priorities | markdown | Ranked list with owner + effort + impact |
43
- | premium_impact_report | markdown | Summary for Aura / executive |
44
- | re_audit_schedule | markdown | Next audit date |
45
-
46
- ## Quality Gates
47
-
48
- - All 7 canonical surfaces are audited (or explicitly excluded with justification)
49
- - Every drift has an impact score
50
- - Remediation priorities have owners assigned
51
- - Billing PDF and transactional email are NOT missing from the audit
52
-
53
- ---
54
-
55
- *squad-artdir v2.0 | Pilar 9 task*
@@ -1,54 +0,0 @@
1
- # Task: Consult SaaS Canon
2
-
3
- ## Metadata
4
- - **ID:** consult-saas-canon
5
- - **Version:** 1.0.0
6
- - **Agent:** platform-aesthetic-director (Vertex) — primary
7
- - **Supporting agents:** analyst (Scope), visual-strategist (Prism)
8
- - **Squad:** squad-artdir
9
- - **Pilars:** 8, 9, 10 (lens)
10
-
11
- ## Description
12
-
13
- Consult the `saas-art-direction-canon.md` KB to extract the most relevant references for a given platform briefing. Decompose the references across the 5 canonical dimensions (Visual DNA, Hero pattern, Design system, Pricing, Onboarding). Return a curated set of principles tailored to the briefing category. Prevents commodity contamination by blocking Pinterest moodboards and stock references.
14
-
15
- ## Inputs
16
-
17
- | Input | Type | Required | Description |
18
- |-------|------|----------|-------------|
19
- | product_category | string | required | Product category (dev tool / fintech / creative tool / ...) |
20
- | audience | string | required | Target audience |
21
- | positioning | string | required | Positioning statement |
22
- | pricing_posture | enum | optional | premium / mainstream / free |
23
- | proposed_references | array | optional | References the user/client is proposing (for commodity audit) |
24
-
25
- ## Steps
26
-
27
- 1. **parse-briefing** — extract category, audience, positioning.
28
- 2. **commodity-audit** — if proposed_references contains Pinterest moodboards, Dribbble shots, or Figma community templates, BLOCK and escalate.
29
- 3. **category-match** — match the category to the closest refs in the canon (dev tool -> Vercel/Raycast; fintech -> Stripe; creative tool -> Framer/Arc; productivity -> Linear).
30
- 4. **decompose-refs** — for the 2-3 most relevant refs, produce the 5-dimension decomposition.
31
- 5. **extract-principles** — derive cross-reference principles relevant to the case.
32
- 6. **identify-custom-craft** — from the refs, identify candidate custom craft elements the new product should consider (e.g., "Vercel owns Geist — this product should own something equivalent").
33
- 7. **feedback-to-agents** — return principles to Axiom (product surface), Atlas (design system), Aura (premium packaging).
34
- 8. **log-consultation** — log the consultation for the quarterly canon review.
35
-
36
- ## Outputs
37
-
38
- | Output | Format | Description |
39
- |--------|--------|-------------|
40
- | canon_consultation | markdown | Full consultation with refs, decomposition, principles |
41
- | category_fit_matrix | markdown | How each canon ref fits (or not) the briefing category |
42
- | custom_craft_candidates | markdown | List of candidate custom craft elements |
43
- | commodity_audit_result | markdown | Pass / fail with blocking reasons |
44
-
45
- ## Quality Gates
46
-
47
- - At least 2 canon refs decomposed for the briefing
48
- - Commodity audit is performed (not skipped)
49
- - Custom craft candidates are identified
50
- - Principles are TRACED to specific refs (not invented)
51
-
52
- ---
53
-
54
- *squad-artdir v2.0 | Canon consultation task*
@@ -1,110 +0,0 @@
1
- # Task: Create Art Direction Brief
2
-
3
- ## Metadata
4
- - **ID:** create-art-direction-brief
5
- - **Version:** 1.0.0
6
- - **Agent:** artdir-orqx (Canvas) orchestrates; visual-strategist (Prism), type-systemist (Kern) contribute
7
- - **Squad:** squad-artdir
8
-
9
- ## Description
10
-
11
- Generate a complete Art Direction Brief with psychological justification for every aesthetic decision. This is the primary deliverable of the squad — the master document that guides all downstream design and development work.
12
-
13
- ## Inputs
14
-
15
- | Input | Type | Required | Description |
16
- |-------|------|----------|-------------|
17
- | briefing | string | required | Project briefing from user or client |
18
- | audience | string | required | Target audience description |
19
- | category | string | required | Market category |
20
- | objective | string | required | Primary conversion objective |
21
- | references | array | optional | Reference URLs or mood references |
22
- | brand_guidelines | string | optional | Existing brand guidelines to respect |
23
- | diagnostic | object | optional | Output from diagnose-visual-language (if existing site) |
24
-
25
- ## Steps
26
-
27
- 1. **parse-briefing**
28
- - Extract project type, audience, category, objective
29
- - Identify constraints from brand guidelines (if any)
30
- - Determine which pillars need highest attention
31
-
32
- 2. **define-visual-language** (Prism)
33
- - Analyze audience expectations
34
- - Research category visual conventions
35
- - Define mood (adjectives, references, territory)
36
- - Decide dark/light mode with justification
37
- - Set density, temperature, weight, contrast, movement levels
38
-
39
- 3. **design-color-system** (Spectrum)
40
- - Select accent color with neuropsychological rationale
41
- - Define neutral palette
42
- - Create semantic colors
43
- - Verify WCAG compliance
44
- - Map Von Restorff application
45
-
46
- 4. **define-typography** (Kern)
47
- - Select font pairing with positioning rationale
48
- - Define type scale (modular, fluid)
49
- - Set tracking and leading per context
50
- - Plan font loading strategy
51
-
52
- 5. **specify-motion** (Tempo)
53
- - Define motion philosophy
54
- - Select libs
55
- - Specify hero technique
56
- - Set easing and timing defaults
57
- - Plan prefers-reduced-motion fallbacks
58
-
59
- 6. **design-ia** (Flow)
60
- - Define section sequence with cognitive roles
61
- - Plan progressive disclosure levels
62
- - Identify Zeigarnik loops and curiosity gaps
63
- - Mark peak and end moments
64
-
65
- 7. **map-cro-patterns** (Convert)
66
- - Select patterns by page type
67
- - Position social proof elements
68
- - Define CTA strategy (primary, secondary, sticky)
69
- - Plan risk reversal approach
70
-
71
- 8. **define-layout** (Grid)
72
- - Set grid system and spacing scale
73
- - Decide full-bleed vs contained per section
74
- - Define responsive breakpoints
75
- - Set section pacing
76
-
77
- 9. **validate-accessibility** (Shield)
78
- - Verify contrast ratios
79
- - Confirm reduced-motion plan
80
- - Check semantic structure plan
81
- - Validate keyboard nav approach
82
-
83
- 10. **compile-brief**
84
- - Consolidate all sections into Art Direction Brief
85
- - Ensure every decision cites psychological principle
86
- - Add impact hypotheses per section
87
- - Generate the remaining 7 deliverables
88
-
89
- ## Outputs
90
-
91
- | Output | Type | Description |
92
- |--------|------|-------------|
93
- | art_direction_brief | document | Complete Art Direction Brief (Deliverable 1) |
94
- | design_tokens | document | Design Token System (Deliverable 2) |
95
- | motion_spec | document | Motion Spec (Deliverable 3) |
96
- | wireflow | document | Annotated Wireflow (Deliverable 4) |
97
- | component_spec | document | Component Library Spec (Deliverable 5) |
98
- | cro_map | document | CRO Patterns Map (Deliverable 6) |
99
- | implementation_guide | document | Implementation Guide (Deliverable 7) |
100
- | validation_checklist | document | Validation Checklist (Deliverable 8) |
101
-
102
- ## Quality Criteria
103
-
104
- - EVERY aesthetic decision MUST cite a psychological principle
105
- - Brief MUST be > 500 lines (comprehensive)
106
- - All 7 pillars MUST be addressed
107
- - WCAG AAA for CTAs, AA for body text — verified
108
- - Impact hypotheses MUST specify metric + direction + rationale
109
- - prefers-reduced-motion fallbacks MUST be defined
110
- - Mobile-first layout MUST be explicit
@@ -1,61 +0,0 @@
1
- # Task: Create Premium Packaging Brief
2
-
3
- ## Metadata
4
- - **ID:** create-premium-packaging-brief
5
- - **Version:** 1.0.0
6
- - **Agent:** premium-packaging-strategist (Aura) — primary
7
- - **Supporting agents:** platform-aesthetic-director (Vertex), design-system-architect (Atlas), product-surface-director (Axiom), type-systemist (Kern), motion-architect (Tempo)
8
- - **Squad:** squad-artdir
9
- - **Pilar:** 10 (Premium Packaging & Perceived Value)
10
-
11
- ## Description
12
-
13
- Produce the Premium Packaging Brief — the master deliverable that justifies and operationalizes premium pricing through art direction. Applies the 5 non-negotiable principles from `premium-packaging-principles.md`. Blocks the brief if the product cannot commit to the 5 principles.
14
-
15
- ## Inputs
16
-
17
- | Input | Type | Required | Description |
18
- |-------|------|----------|-------------|
19
- | product | string | required | Product name + description |
20
- | target_price | number | required | Target price point |
21
- | competitor_price | number | required | Direct competitor reference price |
22
- | multiplier | number | derived | target / competitor (should be >= 2x for this task to apply) |
23
- | brand_tokens | object | optional | Brand token system from squad-brand |
24
- | existing_surfaces | array | optional | Inventory of currently deployed surfaces |
25
-
26
- ## Steps
27
-
28
- 1. **diagnostic-intake** — Aura asks the 5 diagnostic questions. If ANY answer is "no" or "we do not know," escalate with remediation plan.
29
- 2. **select-custom-craft** — identify the ONE custom craft element (type / icon / motion / illustration). Delegate to Kern (type) or Tempo (motion) or squad-brand (icon/illustration) for specification.
30
- 3. **design-strategic-friction** — identify at least one strategic friction point in the funnel. Coordinate with Convert (cro-persuasion) for CRO implications.
31
- 4. **first-5-minutes-choreo** — design the onboarding choreography for the first 5 minutes. Coordinate with Axiom (product-surface-director).
32
- 5. **surface-inventory-audit** — delegate to Atlas via `audit-drift-multi-surface` to audit current state of all 7 canonical surfaces.
33
- 6. **consult-vertex** — Vertex identifies category-fit references from the canon.
34
- 7. **restraint-audit** — apply Principle 1 (restraint reads as confidence). Count accents, type weights, CTAs per viewport.
35
- 8. **assemble-brief** — produce the Premium Packaging Brief deliverable.
36
- 9. **validate-against-pillar-10** — checklist: 5 principles, 5 diagnostic answers, 7 surface inventory.
37
- 10. **handoff-to-canvas** — Canvas (artdir-orqx) integrates the brief with the rest of the art direction deliverables.
38
-
39
- ## Outputs
40
-
41
- | Output | Format | Description |
42
- |--------|--------|-------------|
43
- | premium_packaging_brief | markdown | Master brief with the 5 principles applied |
44
- | custom_craft_spec | markdown | Specification for the ONE custom craft element |
45
- | friction_point_design | markdown | Strategic friction point and justification |
46
- | first_5_minutes_choreography | markdown | Onboarding theater spec |
47
- | restraint_audit | markdown | Accent/type-weight/CTA count vs. principle |
48
- | pillar_10_checklist | markdown | Validation checklist result |
49
-
50
- ## Quality Gates
51
-
52
- - The 5 diagnostic questions ALL have answers (not "we don't know")
53
- - At least ONE custom craft element is identified
54
- - At least ONE strategic friction point is designed
55
- - First 5 Minutes Choreography is documented
56
- - Surface inventory covers all 7 canonical surfaces
57
- - Restraint audit shows: max 1 accent, max 3 type weights, max 3 CTAs/viewport
58
-
59
- ---
60
-
61
- *squad-artdir v2.0 | Pilar 10 task*