agents-united 1.0.0 → 1.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 (250) hide show
  1. package/LICENSE +21 -201
  2. package/README.md +627 -2
  3. package/dist/cli.d.ts +4 -1
  4. package/dist/cli.js +3826 -260
  5. package/dist/cli.js.map +1 -1
  6. package/package.json +9 -3
  7. package/registry/agents/orchestrator-business.md +151 -11
  8. package/registry/agents/orchestrator-design.md +127 -12
  9. package/registry/agents/orchestrator-engineering.md +129 -13
  10. package/registry/agents/orchestrator-marketing.md +134 -11
  11. package/registry/agents/orchestrator-research.md +159 -11
  12. package/registry/agents/orchestrator-security.md +150 -12
  13. package/registry/agents/orchestrator-system-architecture.md +131 -12
  14. package/registry/agents/subagent-accessibility-lead.md +40 -0
  15. package/registry/agents/subagent-ai-model-architect.md +76 -0
  16. package/registry/agents/subagent-android-architect.md +40 -0
  17. package/registry/agents/subagent-backend-architect.md +342 -9
  18. package/registry/agents/subagent-business-panel-experts.md +114 -8
  19. package/registry/agents/subagent-code-reviewer.md +181 -8
  20. package/registry/agents/subagent-cross-platform-specialist.md +40 -0
  21. package/registry/agents/subagent-data-engineer.md +40 -0
  22. package/registry/agents/subagent-deep-research.md +65 -8
  23. package/registry/agents/subagent-design-ops-lead.md +109 -8
  24. package/registry/agents/subagent-design-researcher.md +121 -8
  25. package/registry/agents/subagent-design-systems-architect.md +120 -8
  26. package/registry/agents/subagent-designer-toolkit-expert.md +335 -8
  27. package/registry/agents/subagent-devops-engineer.md +403 -0
  28. package/registry/agents/subagent-distributed-systems-architect.md +40 -0
  29. package/registry/agents/subagent-e2e-tester.md +40 -0
  30. package/registry/agents/subagent-frontend-architect.md +337 -8
  31. package/registry/agents/subagent-interaction-designer.md +288 -8
  32. package/registry/agents/subagent-ios-architect.md +40 -0
  33. package/registry/agents/subagent-lifecycle-email-specialist.md +40 -0
  34. package/registry/agents/subagent-marketing-campaign-specialist.md +66 -8
  35. package/registry/agents/subagent-marketing-content-strategist.md +171 -8
  36. package/registry/agents/subagent-marketing-conversion-specialist.md +66 -8
  37. package/registry/agents/subagent-marketing-creative-designer.md +85 -0
  38. package/registry/agents/subagent-marketing-growth-strategist.md +125 -8
  39. package/registry/agents/subagent-ml-platform-engineer.md +74 -0
  40. package/registry/agents/subagent-paid-acquisition-specialist.md +40 -0
  41. package/registry/agents/subagent-plg-strategist.md +40 -0
  42. package/registry/agents/subagent-prototype-tester.md +114 -8
  43. package/registry/agents/subagent-qa-automation-lead.md +40 -0
  44. package/registry/agents/subagent-repo-index.md +169 -8
  45. package/registry/agents/subagent-security-engineer.md +117 -8
  46. package/registry/agents/subagent-seo-specialist.md +40 -0
  47. package/registry/agents/subagent-socratic-mentor.md +91 -8
  48. package/registry/agents/subagent-sysops-sre-lead.md +62 -0
  49. package/registry/agents/subagent-system-architect.md +106 -8
  50. package/registry/agents/subagent-ui-designer.md +135 -8
  51. package/registry/agents/subagent-ux-strategist.md +75 -8
  52. package/registry/bundles.json +818 -154
  53. package/registry/rules/AGENTS.md +41 -0
  54. package/registry/rules/CLAUDE.md +12 -0
  55. package/registry/rules/CURSOR.md +12 -0
  56. package/registry/rules/GEMINI.md +40 -5
  57. package/registry/rules/clean-code-and-architecture.md +25 -0
  58. package/registry/rules/domain-modeling-and-adr.md +27 -0
  59. package/registry/rules/git-guardrails.md +19 -0
  60. package/registry/rules/multi-agent-coordination.md +33 -0
  61. package/registry/rules/quality-aesthetics-accessibility.md +29 -0
  62. package/registry/rules/skill-attribution.md +27 -0
  63. package/registry/rules/test-driven-development.md +41 -0
  64. package/registry/skills/ab-test-setup/SKILL.md +140 -6
  65. package/registry/skills/accessibility-audit/SKILL.md +147 -0
  66. package/registry/skills/ad-attribution-modeling/SKILL.md +202 -0
  67. package/registry/skills/ad-creative-design/SKILL.md +24 -0
  68. package/registry/skills/ai-prototype-refactoring/SKILL.md +25 -0
  69. package/registry/skills/architecture-design/SKILL.md +133 -7
  70. package/registry/skills/azure-infrastructure-bicep/SKILL.md +24 -0
  71. package/registry/skills/backend-api-design/SKILL.md +148 -0
  72. package/registry/skills/chaos-engineering/SKILL.md +38 -0
  73. package/registry/skills/churn-prevention-playbook/SKILL.md +177 -0
  74. package/registry/skills/ci-cd-pipeline-automation/SKILL.md +37 -0
  75. package/registry/skills/clickable-prototype-spec/SKILL.md +147 -0
  76. package/registry/skills/code-refactoring/SKILL.md +132 -0
  77. package/registry/skills/component-library-management/SKILL.md +147 -0
  78. package/registry/skills/component-playground-setup/SKILL.md +147 -0
  79. package/registry/skills/content-calendar-strategy/SKILL.md +147 -0
  80. package/registry/skills/conversion-funnel-optimization/SKILL.md +147 -0
  81. package/registry/skills/copywriting-frameworks/SKILL.md +147 -0
  82. package/registry/skills/database-design/SKILL.md +132 -0
  83. package/registry/skills/dependency-management/SKILL.md +133 -7
  84. package/registry/skills/design-handoff-spec/SKILL.md +147 -0
  85. package/registry/skills/design-ops-workflow/SKILL.md +147 -0
  86. package/registry/skills/design-system-governance/SKILL.md +147 -0
  87. package/registry/skills/design-system-tokens/SKILL.md +147 -0
  88. package/registry/skills/design-tokens-management/SKILL.md +147 -0
  89. package/registry/skills/design-version-control/SKILL.md +147 -0
  90. package/registry/skills/diagnosing-bugs/SKILL.md +43 -0
  91. package/registry/skills/docker-deployment/SKILL.md +141 -0
  92. package/registry/skills/domain-modeling/SKILL.md +50 -0
  93. package/registry/skills/email-drip-sequences/SKILL.md +177 -0
  94. package/registry/skills/email-marketing-automation/SKILL.md +147 -0
  95. package/registry/skills/finishing-a-development-branch/SKILL.md +123 -7
  96. package/registry/skills/frontend-component-design/SKILL.md +150 -0
  97. package/registry/skills/git-guardrails/SKILL.md +38 -0
  98. package/registry/skills/google-ads-optimization/SKILL.md +24 -0
  99. package/registry/skills/graphql-schema-design/SKILL.md +143 -0
  100. package/registry/skills/grill-me/SKILL.md +51 -0
  101. package/registry/skills/grill-with-docs/SKILL.md +78 -0
  102. package/registry/skills/growth-experiment-design/SKILL.md +147 -0
  103. package/registry/skills/handoff/SKILL.md +41 -0
  104. package/registry/skills/hf-model-evaluation/SKILL.md +80 -0
  105. package/registry/skills/interaction-pattern-library/SKILL.md +147 -0
  106. package/registry/skills/interactive-prototype-builder/SKILL.md +147 -0
  107. package/registry/skills/local-llm-inference/SKILL.md +74 -0
  108. package/registry/skills/maestro-mobile-testing/SKILL.md +37 -0
  109. package/registry/skills/marketing-creative-design/SKILL.md +182 -0
  110. package/registry/skills/meta-ad-creative-testing/SKILL.md +23 -0
  111. package/registry/skills/micro-interaction-design/SKILL.md +147 -0
  112. package/registry/skills/microservices-architecture/SKILL.md +138 -0
  113. package/registry/skills/mobile-android-design/SKILL.md +37 -0
  114. package/registry/skills/mobile-first-design/SKILL.md +147 -0
  115. package/registry/skills/mobile-ios-design/SKILL.md +37 -0
  116. package/registry/skills/mobile-platform-offline-validate/SKILL.md +37 -0
  117. package/registry/skills/modal-serverless-python/SKILL.md +78 -0
  118. package/registry/skills/onboarding-cro/SKILL.md +175 -7
  119. package/registry/skills/paid-acquisition-ppc/SKILL.md +167 -0
  120. package/registry/skills/performance-optimization/SKILL.md +132 -7
  121. package/registry/skills/playwright-best-practices/SKILL.md +36 -0
  122. package/registry/skills/product-launch-playbook/SKILL.md +147 -0
  123. package/registry/skills/programmatic-seo/SKILL.md +203 -7
  124. package/registry/skills/rag-vector-pipeline/SKILL.md +80 -0
  125. package/registry/skills/react-best-practices/SKILL.md +37 -0
  126. package/registry/skills/receiving-code-review/SKILL.md +121 -7
  127. package/registry/skills/replicate-model-inference/SKILL.md +73 -0
  128. package/registry/skills/requesting-code-review/SKILL.md +128 -7
  129. package/registry/skills/responsive-design-audit/SKILL.md +147 -0
  130. package/registry/skills/runpod-gpu-orchestration/SKILL.md +81 -0
  131. package/registry/skills/schema-markup-strategy/SKILL.md +190 -0
  132. package/registry/skills/security-audit/SKILL.md +136 -0
  133. package/registry/skills/seo-audit/SKILL.md +140 -6
  134. package/registry/skills/signup-flow-cro/SKILL.md +140 -6
  135. package/registry/skills/social-media-campaign/SKILL.md +147 -0
  136. package/registry/skills/state-driven-ui-animation/SKILL.md +147 -0
  137. package/registry/skills/subagent-driven-development/SKILL.md +126 -7
  138. package/registry/skills/supabase-backend-architecture/SKILL.md +25 -0
  139. package/registry/skills/systematic-debugging/SKILL.md +129 -7
  140. package/registry/skills/technical-documentation/SKILL.md +133 -0
  141. package/registry/skills/technical-seo-audit/SKILL.md +24 -0
  142. package/registry/skills/telemetry-monitoring/SKILL.md +37 -0
  143. package/registry/skills/test-driven-development/SKILL.md +127 -7
  144. package/registry/skills/to-spec/SKILL.md +43 -0
  145. package/registry/skills/to-tickets/SKILL.md +45 -0
  146. package/registry/skills/turso-distributed-sqlite/SKILL.md +23 -0
  147. package/registry/skills/ui-component-spec/SKILL.md +147 -0
  148. package/registry/skills/usability-testing-protocol/SKILL.md +147 -0
  149. package/registry/skills/user-flow-mapping/SKILL.md +147 -0
  150. package/registry/skills/user-journey-mapping/SKILL.md +147 -0
  151. package/registry/skills/vector-database-design/SKILL.md +80 -0
  152. package/registry/skills/vercel-deploy-best-practices/SKILL.md +24 -0
  153. package/registry/skills/viral-referral-loops/SKILL.md +205 -0
  154. package/registry/workflows/workflow-analyze.md +53 -8
  155. package/registry/workflows/workflow-api-contract-design.md +48 -0
  156. package/registry/workflows/workflow-app-store-release.md +48 -0
  157. package/registry/workflows/workflow-brainstorm.md +53 -8
  158. package/registry/workflows/workflow-build.md +53 -8
  159. package/registry/workflows/workflow-business-panel.md +53 -8
  160. package/registry/workflows/workflow-cleanup.md +53 -8
  161. package/registry/workflows/workflow-deploy-staging.md +49 -0
  162. package/registry/workflows/workflow-design-code.md +53 -8
  163. package/registry/workflows/workflow-design-ops--handoff.md +53 -8
  164. package/registry/workflows/workflow-design-ops--plan-sprint.md +53 -8
  165. package/registry/workflows/workflow-design-ops--setup-workflow.md +53 -8
  166. package/registry/workflows/workflow-design-orchestrate.md +53 -8
  167. package/registry/workflows/workflow-design-systems--audit-system.md +53 -8
  168. package/registry/workflows/workflow-design-systems--create-component.md +53 -8
  169. package/registry/workflows/workflow-design-systems--tokenize.md +53 -8
  170. package/registry/workflows/workflow-diagnose.md +45 -0
  171. package/registry/workflows/workflow-e2e-testing.md +49 -0
  172. package/registry/workflows/workflow-email-drip-sequence.md +65 -0
  173. package/registry/workflows/workflow-estimate.md +53 -8
  174. package/registry/workflows/workflow-explain.md +53 -8
  175. package/registry/workflows/workflow-frontend-audit.md +49 -0
  176. package/registry/workflows/workflow-git.md +53 -8
  177. package/registry/workflows/workflow-grill.md +51 -0
  178. package/registry/workflows/workflow-implement.md +54 -8
  179. package/registry/workflows/workflow-incident-triage.md +49 -0
  180. package/registry/workflows/workflow-interaction-design--design-interaction.md +53 -8
  181. package/registry/workflows/workflow-interaction-design--error-flow.md +53 -8
  182. package/registry/workflows/workflow-interaction-design--map-states.md +53 -8
  183. package/registry/workflows/workflow-marketing-audit.md +53 -8
  184. package/registry/workflows/workflow-marketing-campaign-builder.md +53 -8
  185. package/registry/workflows/workflow-marketing-content-pipeline.md +53 -8
  186. package/registry/workflows/workflow-marketing-growth-experiment.md +53 -8
  187. package/registry/workflows/workflow-marketing-launch.md +53 -8
  188. package/registry/workflows/workflow-marketing-panel.md +53 -8
  189. package/registry/workflows/workflow-ml-eval.md +51 -0
  190. package/registry/workflows/workflow-mobile-build.md +49 -0
  191. package/registry/workflows/workflow-onboarding-funnel-cro.md +65 -0
  192. package/registry/workflows/workflow-paid-acquisition-campaign.md +65 -0
  193. package/registry/workflows/workflow-paid-campaign-launch.md +47 -0
  194. package/registry/workflows/workflow-plan.md +53 -8
  195. package/registry/workflows/workflow-prototyping-testing--evaluate.md +53 -8
  196. package/registry/workflows/workflow-prototyping-testing--experiment.md +53 -8
  197. package/registry/workflows/workflow-prototyping-testing--prototype-plan.md +53 -8
  198. package/registry/workflows/workflow-prototyping-testing--test-plan.md +53 -8
  199. package/registry/workflows/workflow-rag-pipeline-deploy.md +53 -0
  200. package/registry/workflows/workflow-recommend.md +53 -8
  201. package/registry/workflows/workflow-research.md +53 -8
  202. package/registry/workflows/workflow-review.md +53 -8
  203. package/registry/workflows/workflow-seo-audit-pipeline.md +47 -0
  204. package/registry/workflows/workflow-seo-content-pipeline.md +65 -0
  205. package/registry/workflows/workflow-serverless-gpu-deploy.md +52 -0
  206. package/registry/workflows/workflow-spec-panel.md +53 -8
  207. package/registry/workflows/workflow-spec.md +44 -0
  208. package/registry/workflows/workflow-test.md +53 -8
  209. package/registry/workflows/workflow-troubleshoot.md +53 -8
  210. package/registry/workflows/workflow-ui-design--color-palette.md +53 -8
  211. package/registry/workflows/workflow-ui-design--design-screen.md +53 -8
  212. package/registry/workflows/workflow-ui-design--responsive-audit.md +53 -8
  213. package/registry/workflows/workflow-ui-design--type-system.md +53 -8
  214. package/registry/workflows/workflow-ux-strategy--benchmark.md +53 -8
  215. package/registry/workflows/workflow-ux-strategy--frame-problem.md +53 -8
  216. package/registry/workflows/workflow-ux-strategy--strategize.md +53 -8
  217. package/registry/skills/analytics-tracking/SKILL.md +0 -13
  218. package/registry/skills/brainstorming/SKILL.md +0 -13
  219. package/registry/skills/browser-agent/SKILL.md +0 -13
  220. package/registry/skills/campaign-strategy/SKILL.md +0 -13
  221. package/registry/skills/competitor-alternatives/SKILL.md +0 -13
  222. package/registry/skills/confidence-check/SKILL.md +0 -13
  223. package/registry/skills/copy-editing/SKILL.md +0 -13
  224. package/registry/skills/copywriting/SKILL.md +0 -13
  225. package/registry/skills/deep-research/SKILL.md +0 -13
  226. package/registry/skills/design-ops/SKILL.md +0 -13
  227. package/registry/skills/design-research/SKILL.md +0 -13
  228. package/registry/skills/design-systems/SKILL.md +0 -13
  229. package/registry/skills/designer-toolkit/SKILL.md +0 -13
  230. package/registry/skills/email-sequence/SKILL.md +0 -13
  231. package/registry/skills/executing-plans/SKILL.md +0 -13
  232. package/registry/skills/form-cro/SKILL.md +0 -13
  233. package/registry/skills/free-tool-strategy/SKILL.md +0 -13
  234. package/registry/skills/interaction-design/SKILL.md +0 -13
  235. package/registry/skills/launch-strategy/SKILL.md +0 -13
  236. package/registry/skills/marketing-ideas/SKILL.md +0 -13
  237. package/registry/skills/marketing-psychology/SKILL.md +0 -13
  238. package/registry/skills/page-cro/SKILL.md +0 -13
  239. package/registry/skills/paid-ads/SKILL.md +0 -13
  240. package/registry/skills/paywall-upgrade-cro/SKILL.md +0 -13
  241. package/registry/skills/popup-cro/SKILL.md +0 -13
  242. package/registry/skills/pricing-strategy/SKILL.md +0 -13
  243. package/registry/skills/prototyping-testing/SKILL.md +0 -13
  244. package/registry/skills/referral-program/SKILL.md +0 -13
  245. package/registry/skills/schema-markup/SKILL.md +0 -13
  246. package/registry/skills/security-review/SKILL.md +0 -13
  247. package/registry/skills/social-content/SKILL.md +0 -13
  248. package/registry/skills/ui-design/SKILL.md +0 -13
  249. package/registry/skills/ux-strategy/SKILL.md +0 -13
  250. package/registry/skills/writing-plans/SKILL.md +0 -13
@@ -1,15 +1,60 @@
1
- # Workflow: Ui Design Type System
1
+ ---
2
+ name: "Typography System Specification"
3
+ description: "Workflow for defining typographic scales, font families, line heights, font weights, and responsive text sizing."
4
+ bundle: "product-design"
5
+ estimatedDuration: "20-40m"
6
+ ---
2
7
 
3
- Multi-phase procedural workflow for Ui Design Type System.
8
+ # Workflow: Typography System Specification
9
+
10
+ ## Overview & Scope
11
+ The Type System workflow establishes a mathematical typography hierarchy. It defines font stacks, modular scale ratios, line heights, letter spacing, and responsive text utility classes.
12
+
13
+ ## Execution Flowchart
14
+ ```mermaid
15
+ graph TD
16
+ Start([Start Workflow]) --> P1[Phase 1: Context & Reconnaissance]
17
+ P1 --> InputCheck{"Prerequisites & Tools Valid?"}
18
+ InputCheck -->|No| Abort1[Abort & Request Inputs]
19
+ InputCheck -->|Yes| P2[Phase 2: Execution & Orchestration]
20
+ P2 --> Gate1{"Verification Gate: Automated Checks Pass?"}
21
+ Gate1 -->|Fail| Rollback[Execute Automated Rollback Protocol]
22
+ Rollback --> P2
23
+ Gate1 -->|Pass| P3[Phase 3: Verification & Closure]
24
+ P3 --> Gate2{"Final Acceptance Gate Passed?"}
25
+ Gate2 -->|Fail| P3Fix[Remediate Documentation / Artifacts]
26
+ P3Fix --> P3
27
+ Gate2 -->|Pass| Done([Workflow Complete & Logged])
28
+ ```
29
+
30
+ ## Required Tool Inputs & Context
31
+ - Brand typography guidelines & licensed font files
32
+ - Modular scale ratio selection (e.g. Major Third 1.25)
33
+ - Target CSS font stack and fallbacks
4
34
 
5
35
  ## Phase 1: Context & Reconnaissance
6
- - Analyze the user request and existing codebase state.
7
- - Gather necessary inputs and verify environment readiness.
36
+ - Audit existing typographic usage to identify needed scale steps (headings, body, caption, code).
37
+ - Select modular scale ratio matching design aesthetic.
38
+ - Verify web font formats (WOFF2) and fallback system font stacks.
8
39
 
9
40
  ## Phase 2: Execution & Orchestration
10
- - Execute core steps with progressive verifications.
11
- - Delegate sub-tasks to specialized sub-agents.
41
+ - Calculate font size steps (xs: 12px, sm: 14px, base: 16px, lg: 20px, xl: 25px, 2xl: 31px, etc.).
42
+ - Assign relative line-height values (1.2 for headings, 1.5 for body text) to eliminate line collisions.
43
+ - Define typography tokens (`font-heading`, `text-body-md`, `font-weight-semibold`).
12
44
 
13
45
  ## Phase 3: Verification & Closure
14
- - Run verification tests and linting.
15
- - Document outcome and present summary.
46
+ - Test typography rendering across viewports and browsers for legibility.
47
+ - Export typography tokens to CSS variables and Tailwind configuration.
48
+ - Publish Typographic Style Spec document.
49
+
50
+ ## Phase Transition Criteria & Deterministic Verification Gates
51
+ | Transition | Prerequisites | Verification Command / Gate | Success Criteria |
52
+ |---|---|---|---|
53
+ | Phase 1 -> Phase 2 | Tool inputs verified & environment ready | `node dist/cli.js doctor` | Doctor health check succeeds with 0 errors |
54
+ | Phase 2 -> Phase 3 | Execution steps complete | `npm test` | Typography scale test verifies mathematical consistency of font steps |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm run build` | Typography CSS classes compile without syntax errors |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: All font size steps generated according to selected modular scale ratio.
59
+ - **Validation Checkpoint 2**: Every font step includes explicit line-height and letter-spacing specifications.
60
+ - **Automated Rollback Protocol**: Recalculate font step sizes if container constraints cause text wrapping defects.
@@ -1,15 +1,60 @@
1
- # Workflow: Ux Strategy Benchmark
1
+ ---
2
+ name: "Competitive UX Benchmarking & Heuristic Evaluation"
3
+ description: "Workflow for evaluating competitor products, conducting Nielsen-Molich heuristic audits, and identifying UX opportunities."
4
+ bundle: "product-design"
5
+ estimatedDuration: "45-75m"
6
+ ---
2
7
 
3
- Multi-phase procedural workflow for Ux Strategy Benchmark.
8
+ # Workflow: Competitive UX Benchmarking & Heuristic Evaluation
9
+
10
+ ## Overview & Scope
11
+ The UX Benchmark workflow provides a structured approach for auditing competitor interfaces. It applies Nielsen-Molich 10 Usability Heuristics to score UX quality and uncover competitive advantages.
12
+
13
+ ## Execution Flowchart
14
+ ```mermaid
15
+ graph TD
16
+ Start([Start Workflow]) --> P1[Phase 1: Context & Reconnaissance]
17
+ P1 --> InputCheck{"Prerequisites & Tools Valid?"}
18
+ InputCheck -->|No| Abort1[Abort & Request Inputs]
19
+ InputCheck -->|Yes| P2[Phase 2: Execution & Orchestration]
20
+ P2 --> Gate1{"Verification Gate: Automated Checks Pass?"}
21
+ Gate1 -->|Fail| Rollback[Execute Automated Rollback Protocol]
22
+ Rollback --> P2
23
+ Gate1 -->|Pass| P3[Phase 3: Verification & Closure]
24
+ P3 --> Gate2{"Final Acceptance Gate Passed?"}
25
+ Gate2 -->|Fail| P3Fix[Remediate Documentation / Artifacts]
26
+ P3Fix --> P3
27
+ Gate2 -->|Pass| Done([Workflow Complete & Logged])
28
+ ```
29
+
30
+ ## Required Tool Inputs & Context
31
+ - Target competitor product links / screenshots
32
+ - Nielsen 10 Usability Heuristics checklist
33
+ - UX evaluation scoring template
4
34
 
5
35
  ## Phase 1: Context & Reconnaissance
6
- - Analyze the user request and existing codebase state.
7
- - Gather necessary inputs and verify environment readiness.
36
+ - Select 3-5 primary competitor products for benchmarking.
37
+ - Define core user flows for evaluation (e.g. Onboarding, Search & Filter, Checkout/Conversion).
38
+ - Establish scoring criteria (1-5 severity scale for heuristic violations).
8
39
 
9
40
  ## Phase 2: Execution & Orchestration
10
- - Execute core steps with progressive verifications.
11
- - Delegate sub-tasks to specialized sub-agents.
41
+ - Walk through selected user flows on competitor products, taking structured screenshots.
42
+ - Score each flow across Nielsen's 10 Heuristics (Visibility of system status, User control, Consistency, Error prevention, etc.).
43
+ - Identify UX friction patterns, best practices, and market differentiation opportunities.
12
44
 
13
45
  ## Phase 3: Verification & Closure
14
- - Run verification tests and linting.
15
- - Document outcome and present summary.
46
+ - Synthesize audit findings into a Competitive UX Benchmark Matrix.
47
+ - Highlight top UX opportunities and design recommendations.
48
+ - Publish executive UX Benchmark presentation report.
49
+
50
+ ## Phase Transition Criteria & Deterministic Verification Gates
51
+ | Transition | Prerequisites | Verification Command / Gate | Success Criteria |
52
+ |---|---|---|---|
53
+ | Phase 1 -> Phase 2 | Tool inputs verified & environment ready | `node dist/cli.js doctor` | Doctor health check succeeds with 0 errors |
54
+ | Phase 2 -> Phase 3 | Execution steps complete | `node dist/cli.js doctor` | Doctor health check confirms benchmark report artifact structure |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm test` | Benchmark score aggregation script runs cleanly |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: All 10 usability heuristics evaluated for each competitor product flow.
59
+ - **Validation Checkpoint 2**: Actionable recommendations backed by documented screenshot evidence.
60
+ - **Automated Rollback Protocol**: Re-evaluate benchmark scores if inter-rater discrepancy between evaluators exceeds 1.5 points.
@@ -1,15 +1,60 @@
1
- # Workflow: Ux Strategy Frame Problem
1
+ ---
2
+ name: "Problem Framing & User Intent Alignment"
3
+ description: "Workflow for defining core user problem statements, Jobs-to-be-Done (JTBD), success metrics, and project constraints."
4
+ bundle: "product-design"
5
+ estimatedDuration: "30-50m"
6
+ ---
2
7
 
3
- Multi-phase procedural workflow for Ux Strategy Frame Problem.
8
+ # Workflow: Problem Framing & User Intent Alignment
9
+
10
+ ## Overview & Scope
11
+ This workflow aligns product initiatives with genuine user needs. It frames problem statements, constructs Jobs-to-be-Done (JTBD) frameworks, and defines measurable UX success metrics.
12
+
13
+ ## Execution Flowchart
14
+ ```mermaid
15
+ graph TD
16
+ Start([Start Workflow]) --> P1[Phase 1: Context & Reconnaissance]
17
+ P1 --> InputCheck{"Prerequisites & Tools Valid?"}
18
+ InputCheck -->|No| Abort1[Abort & Request Inputs]
19
+ InputCheck -->|Yes| P2[Phase 2: Execution & Orchestration]
20
+ P2 --> Gate1{"Verification Gate: Automated Checks Pass?"}
21
+ Gate1 -->|Fail| Rollback[Execute Automated Rollback Protocol]
22
+ Rollback --> P2
23
+ Gate1 -->|Pass| P3[Phase 3: Verification & Closure]
24
+ P3 --> Gate2{"Final Acceptance Gate Passed?"}
25
+ Gate2 -->|Fail| P3Fix[Remediate Documentation / Artifacts]
26
+ P3Fix --> P3
27
+ Gate2 -->|Pass| Done([Workflow Complete & Logged])
28
+ ```
29
+
30
+ ## Required Tool Inputs & Context
31
+ - User research data, interview notes, or support ticket trends
32
+ - Business goals and strategic objectives
33
+ - Problem framing canvas template
4
34
 
5
35
  ## Phase 1: Context & Reconnaissance
6
- - Analyze the user request and existing codebase state.
7
- - Gather necessary inputs and verify environment readiness.
36
+ - Analyze incoming user feedback, support logs, and analytics data.
37
+ - Identify root user pain points vs surface-level feature requests.
38
+ - Define target user persona profiles and context of use.
8
39
 
9
40
  ## Phase 2: Execution & Orchestration
10
- - Execute core steps with progressive verifications.
11
- - Delegate sub-tasks to specialized sub-agents.
41
+ - Craft core Problem Statement using standard format: "User [X] needs [Y] because [Z]".
42
+ - Develop Jobs-to-be-Done (JTBD) statements: "When [situation], I want to [motivation], so that [outcome]".
43
+ - Formulate "How Might We" (HMW) opportunity prompts for solution generation.
12
44
 
13
45
  ## Phase 3: Verification & Closure
14
- - Run verification tests and linting.
15
- - Document outcome and present summary.
46
+ - Define quantitative UX success metrics (Task Completion Time, Error Rate, System Usability Scale).
47
+ - Validate problem framing canvas with key stakeholders.
48
+ - Publish Problem Framing Canvas artifact.
49
+
50
+ ## Phase Transition Criteria & Deterministic Verification Gates
51
+ | Transition | Prerequisites | Verification Command / Gate | Success Criteria |
52
+ |---|---|---|---|
53
+ | Phase 1 -> Phase 2 | Tool inputs verified & environment ready | `node dist/cli.js doctor` | Doctor health check succeeds with 0 errors |
54
+ | Phase 2 -> Phase 3 | Execution steps complete | `node dist/cli.js doctor` | Doctor health check confirms problem framing document schema |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm test` | Validation test suite confirms presence of metrics and JTBD fields |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: Problem statement focused on user pain points rather than pre-conceived solution implementations.
59
+ - **Validation Checkpoint 2**: Measurable target metrics explicitly defined for problem validation.
60
+ - **Automated Rollback Protocol**: Refine problem framing scope if statement is determined to be overly broad or solution-biased.
@@ -1,15 +1,60 @@
1
- # Workflow: Ux Strategy Strategize
1
+ ---
2
+ name: "Comprehensive UX Strategy Roadmap"
3
+ description: "Strategic workflow for synthesizing research, business goals, and technical feasibility into an actionable multi-horizon UX vision."
4
+ bundle: "product-design"
5
+ estimatedDuration: "60-90m"
6
+ ---
2
7
 
3
- Multi-phase procedural workflow for Ux Strategy Strategize.
8
+ # Workflow: Comprehensive UX Strategy Roadmap
9
+
10
+ ## Overview & Scope
11
+ The UX Strategy workflow connects user experience vision with product execution. It maps UX initiatives across strategic horizons (Horizon 1 immediate, Horizon 2 next, Horizon 3 future) and aligns stakeholders.
12
+
13
+ ## Execution Flowchart
14
+ ```mermaid
15
+ graph TD
16
+ Start([Start Workflow]) --> P1[Phase 1: Context & Reconnaissance]
17
+ P1 --> InputCheck{"Prerequisites & Tools Valid?"}
18
+ InputCheck -->|No| Abort1[Abort & Request Inputs]
19
+ InputCheck -->|Yes| P2[Phase 2: Execution & Orchestration]
20
+ P2 --> Gate1{"Verification Gate: Automated Checks Pass?"}
21
+ Gate1 -->|Fail| Rollback[Execute Automated Rollback Protocol]
22
+ Rollback --> P2
23
+ Gate1 -->|Pass| P3[Phase 3: Verification & Closure]
24
+ P3 --> Gate2{"Final Acceptance Gate Passed?"}
25
+ Gate2 -->|Fail| P3Fix[Remediate Documentation / Artifacts]
26
+ P3Fix --> P3
27
+ Gate2 -->|Pass| Done([Workflow Complete & Logged])
28
+ ```
29
+
30
+ ## Required Tool Inputs & Context
31
+ - Problem framing canvas and competitive benchmark reports
32
+ - Business product roadmap and resource constraints
33
+ - Technical architecture constraints
4
34
 
5
35
  ## Phase 1: Context & Reconnaissance
6
- - Analyze the user request and existing codebase state.
7
- - Gather necessary inputs and verify environment readiness.
36
+ - Gather inputs from problem framing, competitive benchmarking, and technical constraints.
37
+ - Identify core experience principles that will guide design decisions across all features.
38
+ - Audit current user experience debt and friction points.
8
39
 
9
40
  ## Phase 2: Execution & Orchestration
10
- - Execute core steps with progressive verifications.
11
- - Delegate sub-tasks to specialized sub-agents.
41
+ - Map UX initiatives across 3 Strategic Horizons: H1 (Core optimization), H2 (New capabilities), H3 (Transformational experience).
42
+ - Construct feature prioritization matrix (Impact vs Effort grid).
43
+ - Define experience metrics and key performance indicators (KPIs) for each horizon.
12
44
 
13
45
  ## Phase 3: Verification & Closure
14
- - Run verification tests and linting.
15
- - Document outcome and present summary.
46
+ - Validate roadmap feasibility with engineering leads and business leadership.
47
+ - Document UX Strategy Roadmap artifact with milestones and dependencies.
48
+ - Publish executive UX Strategy Summary.
49
+
50
+ ## Phase Transition Criteria & Deterministic Verification Gates
51
+ | Transition | Prerequisites | Verification Command / Gate | Success Criteria |
52
+ |---|---|---|---|
53
+ | Phase 1 -> Phase 2 | Tool inputs verified & environment ready | `node dist/cli.js doctor` | Doctor health check succeeds with 0 errors |
54
+ | Phase 2 -> Phase 3 | Execution steps complete | `node dist/cli.js doctor` | Doctor health check validates UX strategy document structure |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm run build` | Build pipeline confirms documentation artifacts compile cleanly |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: UX strategy aligns directly with documented business goals and user needs.
59
+ - **Validation Checkpoint 2**: Technical feasibility verified with engineering leads for Horizon 1 items.
60
+ - **Automated Rollback Protocol**: Adjust strategic horizon assignments if technical feasibility checks fail.
@@ -1,13 +0,0 @@
1
- ---
2
- name: analytics-tracking
3
- description: Official Analytics Tracking skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Analytics Tracking
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Analytics Tracking.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: brainstorming
3
- description: Official Brainstorming skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Brainstorming
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Brainstorming.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: browser-agent
3
- description: Official Browser Agent skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Browser Agent
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Browser Agent.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: campaign-strategy
3
- description: Official Campaign Strategy skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Campaign Strategy
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Campaign Strategy.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: competitor-alternatives
3
- description: Official Competitor Alternatives skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Competitor Alternatives
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Competitor Alternatives.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: confidence-check
3
- description: Official Confidence Check skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Confidence Check
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Confidence Check.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: copy-editing
3
- description: Official Copy Editing skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Copy Editing
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Copy Editing.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: copywriting
3
- description: Official Copywriting skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Copywriting
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Copywriting.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: deep-research
3
- description: Official Deep Research skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Deep Research
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Deep Research.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: design-ops
3
- description: Official Design Ops skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Design Ops
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Design Ops.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: design-research
3
- description: Official Design Research skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Design Research
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Design Research.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: design-systems
3
- description: Official Design Systems skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Design Systems
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Design Systems.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: designer-toolkit
3
- description: Official Designer Toolkit skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Designer Toolkit
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Designer Toolkit.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: email-sequence
3
- description: Official Email Sequence skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Email Sequence
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Email Sequence.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: executing-plans
3
- description: Official Executing Plans skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Executing Plans
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Executing Plans.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: form-cro
3
- description: Official Form Cro skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Form Cro
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Form Cro.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: free-tool-strategy
3
- description: Official Free Tool Strategy skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Free Tool Strategy
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Free Tool Strategy.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: interaction-design
3
- description: Official Interaction Design skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Interaction Design
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Interaction Design.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: launch-strategy
3
- description: Official Launch Strategy skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Launch Strategy
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Launch Strategy.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: marketing-ideas
3
- description: Official Marketing Ideas skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Marketing Ideas
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Marketing Ideas.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: marketing-psychology
3
- description: Official Marketing Psychology skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Marketing Psychology
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Marketing Psychology.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: page-cro
3
- description: Official Page Cro skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Page Cro
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Page Cro.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: paid-ads
3
- description: Official Paid Ads skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Paid Ads
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Paid Ads.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: paywall-upgrade-cro
3
- description: Official Paywall Upgrade Cro skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Paywall Upgrade Cro
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Paywall Upgrade Cro.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
@@ -1,13 +0,0 @@
1
- ---
2
- name: popup-cro
3
- description: Official Popup Cro skill for Agents United ecosystem providing runbooks and guidelines.
4
- ---
5
-
6
- # Popup Cro
7
-
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Popup Cro.
9
-
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.