agents-united 0.5.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 (236) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +673 -0
  3. package/dist/cli.d.ts +5 -0
  4. package/dist/cli.js +4789 -0
  5. package/dist/cli.js.map +1 -0
  6. package/package.json +77 -0
  7. package/registry/agents/orchestrator-business.md +188 -0
  8. package/registry/agents/orchestrator-design.md +168 -0
  9. package/registry/agents/orchestrator-engineering.md +183 -0
  10. package/registry/agents/orchestrator-marketing.md +228 -0
  11. package/registry/agents/orchestrator-research.md +196 -0
  12. package/registry/agents/orchestrator-security.md +190 -0
  13. package/registry/agents/orchestrator-system-architecture.md +171 -0
  14. package/registry/agents/orchestrator-universal.md +168 -0
  15. package/registry/agents/subagent-accessibility-lead.md +47 -0
  16. package/registry/agents/subagent-ai-model-architect.md +97 -0
  17. package/registry/agents/subagent-android-architect.md +47 -0
  18. package/registry/agents/subagent-appsec-penetration-tester.md +189 -0
  19. package/registry/agents/subagent-backend-architect.md +360 -0
  20. package/registry/agents/subagent-business-panel-experts.md +126 -0
  21. package/registry/agents/subagent-cloud-infrastructure-architect.md +126 -0
  22. package/registry/agents/subagent-cloud-security-architect.md +221 -0
  23. package/registry/agents/subagent-code-reviewer.md +193 -0
  24. package/registry/agents/subagent-compliance-grc-specialist.md +147 -0
  25. package/registry/agents/subagent-cross-platform-specialist.md +47 -0
  26. package/registry/agents/subagent-data-engineer.md +46 -0
  27. package/registry/agents/subagent-database-administrator.md +141 -0
  28. package/registry/agents/subagent-deep-research.md +94 -0
  29. package/registry/agents/subagent-design-ops-lead.md +121 -0
  30. package/registry/agents/subagent-design-researcher.md +133 -0
  31. package/registry/agents/subagent-design-systems-architect.md +134 -0
  32. package/registry/agents/subagent-designer-toolkit-expert.md +363 -0
  33. package/registry/agents/subagent-devops-engineer.md +423 -0
  34. package/registry/agents/subagent-distributed-systems-architect.md +47 -0
  35. package/registry/agents/subagent-e2e-tester.md +60 -0
  36. package/registry/agents/subagent-financial-analyst.md +119 -0
  37. package/registry/agents/subagent-finops-cost-engineer.md +98 -0
  38. package/registry/agents/subagent-frontend-architect.md +368 -0
  39. package/registry/agents/subagent-interaction-designer.md +302 -0
  40. package/registry/agents/subagent-ios-architect.md +46 -0
  41. package/registry/agents/subagent-legal-contract-analyst.md +108 -0
  42. package/registry/agents/subagent-lifecycle-email-specialist.md +46 -0
  43. package/registry/agents/subagent-literature-patent-analyst.md +78 -0
  44. package/registry/agents/subagent-market-intelligence-analyst.md +110 -0
  45. package/registry/agents/subagent-marketing-campaign-specialist.md +80 -0
  46. package/registry/agents/subagent-marketing-content-strategist.md +184 -0
  47. package/registry/agents/subagent-marketing-conversion-specialist.md +79 -0
  48. package/registry/agents/subagent-marketing-creative-designer.md +93 -0
  49. package/registry/agents/subagent-marketing-growth-strategist.md +137 -0
  50. package/registry/agents/subagent-ml-platform-engineer.md +95 -0
  51. package/registry/agents/subagent-operations-strategist.md +85 -0
  52. package/registry/agents/subagent-paid-acquisition-specialist.md +47 -0
  53. package/registry/agents/subagent-plg-strategist.md +46 -0
  54. package/registry/agents/subagent-prototype-tester.md +140 -0
  55. package/registry/agents/subagent-qa-automation-lead.md +63 -0
  56. package/registry/agents/subagent-repo-index.md +180 -0
  57. package/registry/agents/subagent-security-engineer.md +134 -0
  58. package/registry/agents/subagent-seo-specialist.md +46 -0
  59. package/registry/agents/subagent-socratic-mentor.md +105 -0
  60. package/registry/agents/subagent-statistical-analyst.md +132 -0
  61. package/registry/agents/subagent-sysops-sre-lead.md +84 -0
  62. package/registry/agents/subagent-system-architect.md +122 -0
  63. package/registry/agents/subagent-ui-designer.md +149 -0
  64. package/registry/agents/subagent-ux-strategist.md +88 -0
  65. package/registry/bundles.json +1386 -0
  66. package/registry/rules/AGENTS.md +41 -0
  67. package/registry/rules/CLAUDE.md +12 -0
  68. package/registry/rules/CURSOR.md +12 -0
  69. package/registry/rules/GEMINI.md +41 -0
  70. package/registry/rules/clean-code-and-architecture.md +25 -0
  71. package/registry/rules/domain-modeling-and-adr.md +27 -0
  72. package/registry/rules/git-guardrails.md +19 -0
  73. package/registry/rules/multi-agent-coordination.md +33 -0
  74. package/registry/rules/quality-aesthetics-accessibility.md +29 -0
  75. package/registry/rules/skill-attribution.md +27 -0
  76. package/registry/rules/test-driven-development.md +41 -0
  77. package/registry/skills/ab-test-setup/SKILL.md +150 -0
  78. package/registry/skills/accessibility-audit/SKILL.md +150 -0
  79. package/registry/skills/ad-attribution-modeling/SKILL.md +206 -0
  80. package/registry/skills/ad-creative-design/SKILL.md +27 -0
  81. package/registry/skills/ai-prototype-refactoring/SKILL.md +29 -0
  82. package/registry/skills/architecture-design/SKILL.md +141 -0
  83. package/registry/skills/azure-infrastructure-bicep/SKILL.md +28 -0
  84. package/registry/skills/backend-api-design/SKILL.md +151 -0
  85. package/registry/skills/chaos-engineering/SKILL.md +41 -0
  86. package/registry/skills/churn-prevention-playbook/SKILL.md +181 -0
  87. package/registry/skills/ci-cd-pipeline-automation/SKILL.md +40 -0
  88. package/registry/skills/clickable-prototype-spec/SKILL.md +150 -0
  89. package/registry/skills/code-refactoring/SKILL.md +135 -0
  90. package/registry/skills/component-library-management/SKILL.md +150 -0
  91. package/registry/skills/component-playground-setup/SKILL.md +150 -0
  92. package/registry/skills/content-calendar-strategy/SKILL.md +150 -0
  93. package/registry/skills/conversion-funnel-optimization/SKILL.md +150 -0
  94. package/registry/skills/copywriting-frameworks/SKILL.md +150 -0
  95. package/registry/skills/database-design/SKILL.md +135 -0
  96. package/registry/skills/dependency-management/SKILL.md +142 -0
  97. package/registry/skills/design-handoff-spec/SKILL.md +150 -0
  98. package/registry/skills/design-ops-workflow/SKILL.md +150 -0
  99. package/registry/skills/design-system-governance/SKILL.md +150 -0
  100. package/registry/skills/design-system-tokens/SKILL.md +150 -0
  101. package/registry/skills/design-tokens-management/SKILL.md +150 -0
  102. package/registry/skills/design-version-control/SKILL.md +150 -0
  103. package/registry/skills/diagnosing-bugs/SKILL.md +45 -0
  104. package/registry/skills/docker-deployment/SKILL.md +144 -0
  105. package/registry/skills/domain-modeling/SKILL.md +52 -0
  106. package/registry/skills/email-drip-sequences/SKILL.md +181 -0
  107. package/registry/skills/email-marketing-automation/SKILL.md +150 -0
  108. package/registry/skills/finishing-a-development-branch/SKILL.md +132 -0
  109. package/registry/skills/frontend-component-design/SKILL.md +153 -0
  110. package/registry/skills/git-guardrails/SKILL.md +41 -0
  111. package/registry/skills/google-ads-optimization/SKILL.md +27 -0
  112. package/registry/skills/graphql-schema-design/SKILL.md +146 -0
  113. package/registry/skills/grill-me/SKILL.md +57 -0
  114. package/registry/skills/grill-with-docs/SKILL.md +84 -0
  115. package/registry/skills/growth-experiment-design/SKILL.md +150 -0
  116. package/registry/skills/handoff/SKILL.md +44 -0
  117. package/registry/skills/hf-model-evaluation/SKILL.md +84 -0
  118. package/registry/skills/interaction-pattern-library/SKILL.md +150 -0
  119. package/registry/skills/interactive-prototype-builder/SKILL.md +157 -0
  120. package/registry/skills/local-llm-inference/SKILL.md +77 -0
  121. package/registry/skills/maestro-mobile-testing/SKILL.md +40 -0
  122. package/registry/skills/marketing-creative-design/SKILL.md +186 -0
  123. package/registry/skills/mcp-setup/SKILL.md +370 -0
  124. package/registry/skills/meta-ad-creative-testing/SKILL.md +26 -0
  125. package/registry/skills/micro-interaction-design/SKILL.md +150 -0
  126. package/registry/skills/microservices-architecture/SKILL.md +141 -0
  127. package/registry/skills/mobile-android-design/SKILL.md +40 -0
  128. package/registry/skills/mobile-first-design/SKILL.md +150 -0
  129. package/registry/skills/mobile-ios-design/SKILL.md +40 -0
  130. package/registry/skills/mobile-platform-offline-validate/SKILL.md +41 -0
  131. package/registry/skills/modal-serverless-python/SKILL.md +81 -0
  132. package/registry/skills/onboarding-cro/SKILL.md +185 -0
  133. package/registry/skills/paid-acquisition-ppc/SKILL.md +171 -0
  134. package/registry/skills/performance-optimization/SKILL.md +141 -0
  135. package/registry/skills/playwright-best-practices/SKILL.md +39 -0
  136. package/registry/skills/product-launch-playbook/SKILL.md +150 -0
  137. package/registry/skills/programmatic-seo/SKILL.md +213 -0
  138. package/registry/skills/rag-vector-pipeline/SKILL.md +84 -0
  139. package/registry/skills/react-best-practices/SKILL.md +40 -0
  140. package/registry/skills/receiving-code-review/SKILL.md +130 -0
  141. package/registry/skills/replicate-model-inference/SKILL.md +76 -0
  142. package/registry/skills/requesting-code-review/SKILL.md +137 -0
  143. package/registry/skills/responsive-design-audit/SKILL.md +150 -0
  144. package/registry/skills/runpod-gpu-orchestration/SKILL.md +85 -0
  145. package/registry/skills/schema-markup-strategy/SKILL.md +194 -0
  146. package/registry/skills/security-audit/SKILL.md +139 -0
  147. package/registry/skills/seo-audit/SKILL.md +150 -0
  148. package/registry/skills/signup-flow-cro/SKILL.md +150 -0
  149. package/registry/skills/social-media-campaign/SKILL.md +150 -0
  150. package/registry/skills/state-driven-ui-animation/SKILL.md +150 -0
  151. package/registry/skills/subagent-driven-development/SKILL.md +135 -0
  152. package/registry/skills/supabase-backend-architecture/SKILL.md +28 -0
  153. package/registry/skills/systematic-debugging/SKILL.md +138 -0
  154. package/registry/skills/technical-documentation/SKILL.md +136 -0
  155. package/registry/skills/technical-seo-audit/SKILL.md +27 -0
  156. package/registry/skills/telemetry-monitoring/SKILL.md +40 -0
  157. package/registry/skills/test-driven-development/SKILL.md +135 -0
  158. package/registry/skills/to-spec/SKILL.md +48 -0
  159. package/registry/skills/to-tickets/SKILL.md +47 -0
  160. package/registry/skills/turso-distributed-sqlite/SKILL.md +27 -0
  161. package/registry/skills/ui-component-spec/SKILL.md +150 -0
  162. package/registry/skills/usability-testing-protocol/SKILL.md +150 -0
  163. package/registry/skills/user-flow-mapping/SKILL.md +150 -0
  164. package/registry/skills/user-journey-mapping/SKILL.md +150 -0
  165. package/registry/skills/vector-database-design/SKILL.md +84 -0
  166. package/registry/skills/vercel-deploy-best-practices/SKILL.md +28 -0
  167. package/registry/skills/viral-referral-loops/SKILL.md +209 -0
  168. package/registry/workflows/workflow-agency-ad-creative-sprint.md +50 -0
  169. package/registry/workflows/workflow-agency-brand-design-system.md +50 -0
  170. package/registry/workflows/workflow-agency-client-pitch-proposal.md +50 -0
  171. package/registry/workflows/workflow-agency-cro-funnel-teardown.md +50 -0
  172. package/registry/workflows/workflow-agency-full-campaign.md +58 -0
  173. package/registry/workflows/workflow-agency-seo-content-engine.md +50 -0
  174. package/registry/workflows/workflow-analyze.md +60 -0
  175. package/registry/workflows/workflow-api-contract-design.md +48 -0
  176. package/registry/workflows/workflow-app-store-release.md +48 -0
  177. package/registry/workflows/workflow-brainstorm.md +60 -0
  178. package/registry/workflows/workflow-build.md +60 -0
  179. package/registry/workflows/workflow-business-panel.md +60 -0
  180. package/registry/workflows/workflow-cleanup.md +60 -0
  181. package/registry/workflows/workflow-deploy-staging.md +49 -0
  182. package/registry/workflows/workflow-design-code.md +60 -0
  183. package/registry/workflows/workflow-design-ops--handoff.md +60 -0
  184. package/registry/workflows/workflow-design-ops--plan-sprint.md +60 -0
  185. package/registry/workflows/workflow-design-ops--setup-workflow.md +60 -0
  186. package/registry/workflows/workflow-design-orchestrate.md +60 -0
  187. package/registry/workflows/workflow-design-systems--audit-system.md +60 -0
  188. package/registry/workflows/workflow-design-systems--create-component.md +60 -0
  189. package/registry/workflows/workflow-design-systems--tokenize.md +60 -0
  190. package/registry/workflows/workflow-diagnose.md +45 -0
  191. package/registry/workflows/workflow-e2e-testing.md +49 -0
  192. package/registry/workflows/workflow-email-drip-sequence.md +65 -0
  193. package/registry/workflows/workflow-estimate.md +60 -0
  194. package/registry/workflows/workflow-explain.md +60 -0
  195. package/registry/workflows/workflow-frontend-audit.md +49 -0
  196. package/registry/workflows/workflow-git.md +60 -0
  197. package/registry/workflows/workflow-grill.md +51 -0
  198. package/registry/workflows/workflow-implement.md +61 -0
  199. package/registry/workflows/workflow-incident-triage.md +49 -0
  200. package/registry/workflows/workflow-interaction-design--design-interaction.md +60 -0
  201. package/registry/workflows/workflow-interaction-design--error-flow.md +60 -0
  202. package/registry/workflows/workflow-interaction-design--map-states.md +60 -0
  203. package/registry/workflows/workflow-marketing-audit.md +60 -0
  204. package/registry/workflows/workflow-marketing-campaign-builder.md +60 -0
  205. package/registry/workflows/workflow-marketing-content-pipeline.md +60 -0
  206. package/registry/workflows/workflow-marketing-growth-experiment.md +60 -0
  207. package/registry/workflows/workflow-marketing-launch.md +60 -0
  208. package/registry/workflows/workflow-marketing-panel.md +60 -0
  209. package/registry/workflows/workflow-ml-eval.md +51 -0
  210. package/registry/workflows/workflow-mobile-build.md +49 -0
  211. package/registry/workflows/workflow-onboarding-funnel-cro.md +65 -0
  212. package/registry/workflows/workflow-paid-acquisition-campaign.md +65 -0
  213. package/registry/workflows/workflow-paid-campaign-launch.md +47 -0
  214. package/registry/workflows/workflow-plan.md +60 -0
  215. package/registry/workflows/workflow-prototyping-testing--evaluate.md +60 -0
  216. package/registry/workflows/workflow-prototyping-testing--experiment.md +60 -0
  217. package/registry/workflows/workflow-prototyping-testing--prototype-plan.md +60 -0
  218. package/registry/workflows/workflow-prototyping-testing--test-plan.md +60 -0
  219. package/registry/workflows/workflow-rag-pipeline-deploy.md +53 -0
  220. package/registry/workflows/workflow-recommend.md +60 -0
  221. package/registry/workflows/workflow-research.md +60 -0
  222. package/registry/workflows/workflow-review.md +60 -0
  223. package/registry/workflows/workflow-seo-audit-pipeline.md +47 -0
  224. package/registry/workflows/workflow-seo-content-pipeline.md +65 -0
  225. package/registry/workflows/workflow-serverless-gpu-deploy.md +52 -0
  226. package/registry/workflows/workflow-spec-panel.md +60 -0
  227. package/registry/workflows/workflow-spec.md +44 -0
  228. package/registry/workflows/workflow-test.md +60 -0
  229. package/registry/workflows/workflow-troubleshoot.md +60 -0
  230. package/registry/workflows/workflow-ui-design--color-palette.md +60 -0
  231. package/registry/workflows/workflow-ui-design--design-screen.md +60 -0
  232. package/registry/workflows/workflow-ui-design--responsive-audit.md +60 -0
  233. package/registry/workflows/workflow-ui-design--type-system.md +60 -0
  234. package/registry/workflows/workflow-ux-strategy--benchmark.md +60 -0
  235. package/registry/workflows/workflow-ux-strategy--frame-problem.md +60 -0
  236. package/registry/workflows/workflow-ux-strategy--strategize.md +60 -0
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: "Component State Matrix Mapping"
3
+ description: "Workflow for systematically mapping and documenting all UI component states (default, hover, focus, active, disabled, loading, error)."
4
+ bundle: "product-design"
5
+ estimatedDuration: "20-35m"
6
+ ---
7
+
8
+ # Workflow: Component State Matrix Mapping
9
+
10
+ ## Overview & Scope
11
+ This workflow guarantees complete UI component state coverage. It maps the 7 fundamental component states, ensuring consistent visual and keyboard behavior across the application.
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
+ - Component visual designs & design tokens
32
+ - Accessibility focus ring guidelines (contrast >= 3:1)
33
+ - Component state checklist
34
+
35
+ ## Phase 1: Context & Reconnaissance
36
+ - List target components requiring state mapping (buttons, text inputs, checkboxes, dropdowns, toggles).
37
+ - Identify visual property changes for each state transition (background, border, shadow, opacity).
38
+ - Verify keyboard focus styling rules.
39
+
40
+ ## Phase 2: Execution & Orchestration
41
+ - Document visual design specs for all 7 standard states: Default, Hover, Focus-Visible, Active (Pressed), Disabled, Loading, Error.
42
+ - Define state transition rules and visual indicators (spinner for loading, greyed out for disabled).
43
+ - Verify focus ring meets WCAG 2.1 visible focus requirements.
44
+
45
+ ## Phase 3: Verification & Closure
46
+ - Audit component state matrix for missing state specs.
47
+ - Export state matrix specifications to design system component docs.
48
+ - Publish Component State Checklist.
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` | State matrix test verifies 100% state coverage for all cataloged components |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm run build` | Component CSS state classes build without compilation errors |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: All 7 component states explicitly specified for every cataloged component.
59
+ - **Validation Checkpoint 2**: Focus-visible state ring has >= 3:1 contrast ratio against adjacent surfaces.
60
+ - **Automated Rollback Protocol**: Add missing state specifications before releasing component to component library.
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: "Growth & Marketing Funnel Audit"
3
+ description: "Comprehensive workflow for auditing acquisition channels, conversion funnels, landing page performance, and analytics tracking."
4
+ bundle: "growth-marketing"
5
+ estimatedDuration: "45-80m"
6
+ ---
7
+
8
+ # Workflow: Growth & Marketing Funnel Audit
9
+
10
+ ## Overview & Scope
11
+ This workflow conducts end-to-end marketing audits. It inspects acquisition channels, conversion funnel drop-off metrics, landing page technical SEO, page speed, and analytics event tracking.
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
+ - Analytics dataset exports (funnel drop-offs, conversion rates)
32
+ - Landing page URLs & technical SEO audit tools
33
+ - Target funnel stage definitions
34
+
35
+ ## Phase 1: Context & Reconnaissance
36
+ - Map full user acquisition funnel (Traffic -> Landing Page -> Signup -> Activation -> Paid Conversion).
37
+ - Extract analytics drop-off metrics across each funnel transition step.
38
+ - Prepare technical SEO and landing page speed scanner tools.
39
+
40
+ ## Phase 2: Execution & Orchestration
41
+ - Identify high-drop-off funnel bottlenecks and conversion friction points.
42
+ - Audit landing page technical SEO (meta tags, open graph, structured schema) and Core Web Vitals.
43
+ - Inspect analytics event tracking setup to verify accuracy of conversion logging.
44
+
45
+ ## Phase 3: Verification & Closure
46
+ - Synthesize audit findings into an Impact vs Effort Growth Opportunity Matrix.
47
+ - Create prioritized remediation backlog targeting high-leverage conversion fixes.
48
+ - Publish Growth & Marketing Funnel Audit 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 | `npm test` | Funnel analytics script verifies data consistency across conversion stages |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm run build` | Build pipeline validates audit report compilation |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: All acquisition funnel drop-off points quantified with analytics baseline data.
59
+ - **Validation Checkpoint 2**: Technical SEO issues cataloged with actionable remediation fixes.
60
+ - **Automated Rollback Protocol**: Re-verify analytics tracking tags if data anomalies pollute funnel audit calculations.
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: "Multi-Channel Marketing Campaign Construction"
3
+ description: "End-to-end workflow for building integrated marketing campaigns across email, social media, paid ads, and landing pages."
4
+ bundle: "growth-marketing"
5
+ estimatedDuration: "60-120m"
6
+ ---
7
+
8
+ # Workflow: Multi-Channel Marketing Campaign Construction
9
+
10
+ ## Overview & Scope
11
+ The Campaign Builder workflow constructs integrated multi-channel marketing campaigns. It orchestrates landing page creation, email drip sequences, ad creative assets, and UTM tracking parameters.
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
+ - Marketing campaign brief & strategy roadmap
32
+ - Channel creative templates (email HTML, ad banners, social posts)
33
+ - UTM parameter taxonomy guidelines
34
+
35
+ ## Phase 1: Context & Reconnaissance
36
+ - Establish campaign goals (lead generation, feature announcement, webinar signups).
37
+ - Define target channels (Email, Twitter/X, LinkedIn, Google Ads, Meta Ads).
38
+ - Confirm campaign budget, schedule, and UTM tracking structure.
39
+
40
+ ## Phase 2: Execution & Orchestration
41
+ - Draft campaign landing page copy and configure opt-in form integration.
42
+ - Write multi-step email nurture sequence (Welcome, Value delivery, Social proof, Offer CTA).
43
+ - Generate ad banner visual assets and social media post copy variations with UTM links.
44
+
45
+ ## Phase 3: Verification & Closure
46
+ - Test campaign links in analytics sandbox to verify UTM parameter tracking.
47
+ - Preview email rendering across email clients (mobile, desktop, dark mode).
48
+ - Publish Campaign Execution Blueprint.
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` | UTM link validator verifies 100% of campaign links contain correct tracking parameters |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm run build` | Email HTML templates and campaign assets build without errors |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: All UTM tracking parameters configured and verified in analytics test environment.
59
+ - **Validation Checkpoint 2**: Campaign copy matches approved brand messaging brief across all channels.
60
+ - **Automated Rollback Protocol**: Pause campaign rollout if link tracking parameters fail to log in analytics test sandbox.
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: "Content Engine & SEO Pipeline"
3
+ description: "Workflow for keyword research, content drafting, SEO optimization, editorial review, and content publishing."
4
+ bundle: "growth-marketing"
5
+ estimatedDuration: "45-90m"
6
+ ---
7
+
8
+ # Workflow: Content Engine & SEO Pipeline
9
+
10
+ ## Overview & Scope
11
+ This workflow drives the content engine. It structures keyword research, topic clustering, SEO-optimized article drafting, Schema.org markup validation, and CMS publishing.
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 search query keyword research data
32
+ - Editorial style guide and content guidelines
33
+ - SEO optimization scanner & Schema.org validator
34
+
35
+ ## Phase 1: Context & Reconnaissance
36
+ - Identify target search queries, search intent, and top-ranking competitor content.
37
+ - Develop article outline featuring target primary keyword and supporting LSI keywords.
38
+ - Select Schema.org structured data type (Article, BlogPosting, HowTo).
39
+
40
+ ## Phase 2: Execution & Orchestration
41
+ - Draft comprehensive content article addressing search intent with depth and clarity.
42
+ - Incorporate internal links to related product pages and authoritative external sources.
43
+ - Write optimized title tag, meta description, H1/H2 headings, and image alt text.
44
+
45
+ ## Phase 3: Verification & Closure
46
+ - Perform readability check (Flesch-Kincaid score) and verify keyword density (1-2%).
47
+ - Validate Schema.org JSON-LD structured data using rich result validator tools.
48
+ - Publish article to CMS repository.
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` | SEO content test suite validates Schema.org JSON-LD syntax |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm run build` | CMS static site generator builds page cleanly |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: Article satisfies word count and keyword intent coverage requirements.
59
+ - **Validation Checkpoint 2**: Schema.org structured data passes validation test with zero errors.
60
+ - **Automated Rollback Protocol**: Re-draft article sections if readability grade level falls outside target parameters.
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: "A/B Growth Experiment Design & Tracking"
3
+ description: "Workflow for designing A/B split tests, configuring experiment variants, setting up tracking events, and evaluating statistical significance."
4
+ bundle: "growth-marketing"
5
+ estimatedDuration: "35-60m"
6
+ ---
7
+
8
+ # Workflow: A/B Growth Experiment Design & Tracking
9
+
10
+ ## Overview & Scope
11
+ The Growth Experiment workflow structures scientific A/B testing. It defines hypotheses, designs control and challenger variants, configures event tracking, and calculates statistical significance.
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
+ - Growth hypothesis statement
32
+ - A/B testing framework / feature flag system (PostHog / LaunchDarkly)
33
+ - Baseline metric conversion rates
34
+
35
+ ## Phase 1: Context & Reconnaissance
36
+ - Formulate experiment hypothesis: "If [change], then [impact] because [rationale]".
37
+ - Calculate required sample size and test duration for 95% statistical power.
38
+ - Define primary conversion metric and secondary guardrail metrics.
39
+
40
+ ## Phase 2: Execution & Orchestration
41
+ - Configure Variant A (Control) and Variant B (Challenger) in experiment platform.
42
+ - Implement analytics event tracking triggers for conversion actions.
43
+ - Run sample ratio mismatch (SRM) test to verify unbiased 50/50 traffic split.
44
+
45
+ ## Phase 3: Verification & Closure
46
+ - Monitor experiment health during initial traffic rollout.
47
+ - Evaluate conversion results once required sample size is reached, calculating p-value.
48
+ - Publish Growth Experiment Results & Learnings 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 | `npm test` | Experiment tracking suite validates event logging for both variants |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm run build` | Experiment feature flag code builds without type errors |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: Sample ratio mismatch (SRM) test confirms unbiased traffic allocation.
59
+ - **Validation Checkpoint 2**: Statistical significance reaches >= 95% confidence before declaring winning variant.
60
+ - **Automated Rollback Protocol**: Disable challenger experiment variant immediately if conversion drops severely during rollout.
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: "Product Launch Playbook Execution"
3
+ description: "Structured workflow for coordinating product launches across Product Hunt, social channels, press releases, customer emails, and community platforms."
4
+ bundle: "growth-marketing"
5
+ estimatedDuration: "60-120m"
6
+ ---
7
+
8
+ # Workflow: Product Launch Playbook Execution
9
+
10
+ ## Overview & Scope
11
+ The Launch workflow coordinates product launch execution. It orchestrates Product Hunt launches, social media announcements, customer email blasts, press releases, and real-time launch operations.
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
+ - Product release notes & feature highlights
32
+ - Media kit assets (logos, screenshots, promotional videos)
33
+ - Multi-channel launch checklist
34
+
35
+ ## Phase 1: Context & Reconnaissance
36
+ - Confirm product stability and verify production environment readiness.
37
+ - Verify all promotional creative, media kits, and link destinations are staged.
38
+ - Align launch team roles and monitoring responsibilities for launch day.
39
+
40
+ ## Phase 2: Execution & Orchestration
41
+ - Publish launch post on Product Hunt, Hacker News, Twitter/X, and LinkedIn.
42
+ - Trigger launch email blast to subscriber mailing list.
43
+ - Engage with community comments and answer user feedback in real time.
44
+
45
+ ## Phase 3: Verification & Closure
46
+ - Monitor server infrastructure load, signup conversion rates, and error logs.
47
+ - Compile day-1 launch analytics summary (upvotes, signups, traffic sources).
48
+ - Publish Post-Launch Retrospective 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 | `npm test` | Launch checklist validator confirms 100% prerequisite tasks complete |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `node dist/cli.js doctor` | Doctor health check confirms system readiness |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: Product onboarding and signup flows verified operational under traffic load.
59
+ - **Validation Checkpoint 2**: All scheduled channel launch posts published successfully.
60
+ - **Automated Rollback Protocol**: Divert traffic to status fallback page if servers experience unexpected downtime during launch.
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: "Marketing & Messaging Review Panel"
3
+ description: "Panel workflow assembling growth, content, copy, and conversion specialists to evaluate marketing positioning and campaigns."
4
+ bundle: "growth-marketing"
5
+ estimatedDuration: "40-70m"
6
+ ---
7
+
8
+ # Workflow: Marketing & Messaging Review Panel
9
+
10
+ ## Overview & Scope
11
+ The Marketing Panel workflow evaluates campaign messaging and positioning. It convenes Growth Strategists, Copywriters, and Conversion Specialists to review value propositions, CTA clarity, and brand voice.
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
+ - Marketing campaign brief & copy drafts
32
+ - Value proposition canvas and target audience personas
33
+ - Brand positioning guidelines
34
+
35
+ ## Phase 1: Context & Reconnaissance
36
+ - Gather marketing assets, landing page copy, email drafts, and ad creative.
37
+ - Define evaluation dimensions (Value messaging clarity, Emotional resonance, Call-to-action strength, Brand tone).
38
+ - Distribute copy drafts to marketing panel personas.
39
+
40
+ ## Phase 2: Execution & Orchestration
41
+ - Conduct panel review session collecting structured feedback across marketing specialist roles.
42
+ - Audit copy for jargon, ambiguous claims, and value clarity above the page fold.
43
+ - Identify positioning friction and formulate copy optimization suggestions.
44
+
45
+ ## Phase 3: Verification & Closure
46
+ - Synthesize panel feedback into Marketing Review Verdict (Approved, Approved with Copy Edits, Rejected).
47
+ - Draft actionable copy revision guide with line-by-line recommendations.
48
+ - Publish Marketing Panel Review 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 confirms marketing panel report format |
55
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm test` | Validation tests pass for copy audit report artifacts |
56
+
57
+ ## Validation Checkpoints & Automated Rollback Protocols
58
+ - **Validation Checkpoint 1**: Core value proposition clearly communicated within first fold screen area.
59
+ - **Validation Checkpoint 2**: Zero confusing jargon or unsubstantiated claims in hero section copy.
60
+ - **Automated Rollback Protocol**: Reject campaign copy for re-write if message clarity score falls below evaluation threshold.
@@ -0,0 +1,51 @@
1
+ ---
2
+ name: "ML Model Evaluation & Benchmarking Workflow"
3
+ description: "Rigorous model evaluation, synthetic benchmark testing, faithfulness scoring, and Hugging Face scorecard generation."
4
+ bundle: "ai-ml-engineering"
5
+ estimatedDuration: "30-60m"
6
+ ---
7
+
8
+ # Workflow: ML Model Evaluation & Benchmarking
9
+
10
+ ## Overview & Scope
11
+ This workflow coordinates systematic evaluation of fine-tuned and open-source models against standardized benchmark datasets, measuring faithfulness, context relevancy, and inference latency.
12
+
13
+ ## Execution Flowchart
14
+ ```mermaid
15
+ graph TD
16
+ Start([Start Evaluation]) --> P1[Phase 1: Dataset & Metric Configuration]
17
+ P1 --> InputCheck{"Evaluation Dataset & Golden QA Set Valid?"}
18
+ InputCheck -->|No| Abort1[Abort & Request Validation Dataset]
19
+ InputCheck -->|Yes| P2[Phase 2: Benchmark Execution & Scoring]
20
+ P2 --> Gate1{"Verification Gate: Benchmark Run Complete?"}
21
+ Gate1 -->|Fail| P2Fix[Adjust Batch Size / Re-run Inference]
22
+ P2Fix --> P2
23
+ Gate1 -->|Pass| P3[Phase 3: Analysis & Model Card Publish]
24
+ P3 --> Gate2{"Quality Gate: Accuracy & Faithfulness > Threshold?"}
25
+ Gate2 -->|Fail| FlagModel[Flag Model for Retraining / Prompt Tuning]
26
+ Gate2 -->|Pass| Done([Model Evaluation Signed Off])
27
+ ```
28
+
29
+ ## Phase 1: Dataset & Metric Configuration
30
+ - Load golden QA evaluation splits or standardized benchmarks (MMLU, GSM8k, Ragas synthetic testsets).
31
+ - Define evaluation thresholds (e.g. Faithfulness >= 0.85, Answer Relevance >= 0.80).
32
+
33
+ ## Phase 2: Benchmark Execution & Scoring
34
+ - Execute deterministic batch inference across evaluation splits with fixed random seeds.
35
+ - Compute automated metrics (Exact Match, BLEU/ROUGE, Ragas LLM-as-a-judge scores).
36
+
37
+ ## Phase 3: Analysis & Model Card Publish
38
+ - Analyze error distribution and hallucination clusters.
39
+ - Generate Hugging Face model evaluation scorecard and publish metrics summary.
40
+
41
+ ## Phase Transition Criteria & Deterministic Verification Gates
42
+ | Transition | Prerequisites | Verification Command / Gate | Success Criteria |
43
+ |---|---|---|---|
44
+ | Phase 1 -> Phase 2 | Datasets validated | `node dist/cli.js doctor` | Evaluation harness initialized |
45
+ | Phase 2 -> Phase 3 | Scoring complete | `npm test` | Benchmark outputs parsed into structured metrics |
46
+ | Phase 3 -> Completion | Metrics meet quality bar | `node dist/cli.js doctor` | Scorecard published and verified |
47
+
48
+ ## Validation Checkpoints & Automated Rollback Protocols
49
+ - **Validation Checkpoint 1**: Verify dataset schema compliance and label distributions before starting benchmark run.
50
+ - **Validation Checkpoint 2**: Ensure deterministic seed produces identical predictions on sample batch.
51
+ - **Automated Rollback Protocol**: If evaluation reveals critical toxicity regression or accuracy drop > 5%, revert model deployment target to previous checkpoint baseline and emit alert.
@@ -0,0 +1,49 @@
1
+ ---
2
+ name: "Mobile Multi-Platform Build & Verification"
3
+ description: "Workflow for executing cross-platform mobile builds (iOS/Android/Expo), verifying asset bundle sizes, and checking native compilation status."
4
+ bundle: "mobile-development"
5
+ estimatedDuration: "15-30m"
6
+ ---
7
+
8
+ # Workflow: Mobile Multi-Platform Build & Verification
9
+
10
+ ## Overview & Scope
11
+ The Mobile Build workflow compiles native and cross-platform mobile application packages (IPA / APK / AAB / Expo EAS), validating binary size, asset optimization, and compiler flags.
12
+
13
+ ## Execution Flowchart
14
+ ```mermaid
15
+ graph TD
16
+ Start([Start Workflow]) --> P1[Phase 1: Environment & Dependency Check]
17
+ P1 --> InputCheck{"Podfile & Gradle Ready?"}
18
+ InputCheck -->|No| Abort1[Abort & Resolve Dependencies]
19
+ InputCheck -->|Yes| P2[Phase 2: Compilation & Asset Bundling]
20
+ P2 --> Gate1{"Verification Gate: Compilation Exit Code 0?"}
21
+ Gate1 -->|Fail| Rollback[Inspect Build Logs & Fix Compilation Errors]
22
+ Rollback --> P2
23
+ Gate1 -->|Pass| P3[Phase 3: Binary Inspection & Artifact Sign-off]
24
+ P3 --> Done([Mobile Build Package Ready])
25
+ ```
26
+
27
+ ## Required Tool Inputs & Context
28
+ - Target mobile platform (`ios`, `android`, `all`)
29
+ - Build type (`debug`, `release`)
30
+ - Xcode / Android SDK environment setup
31
+
32
+ ## Phase 1: Environment & Dependency Check
33
+ - Inspect native configuration files (`Podfile`, `build.gradle`, `app.json`).
34
+ - Verify signing identities and bundle identifiers.
35
+
36
+ ## Phase 2: Compilation & Asset Bundling
37
+ - Execute compilation (`xcodebuild` / `./gradlew assembleRelease` / `eas build --local`).
38
+ - Check output for deprecated API usages or symbol collision warnings.
39
+
40
+ ## Phase 3: Binary Inspection & Artifact Sign-off
41
+ - Audit final binary file size against mobile app budget (< 50MB target).
42
+ - Verify entry point manifest and permission declarations.
43
+
44
+ ## Phase Transition Criteria & Deterministic Verification Gates
45
+ | Transition | Prerequisites | Verification Command / Gate | Success Criteria |
46
+ |---|---|---|---|
47
+ | Phase 1 -> Phase 2 | Dependencies resolved | `npm run lint` / `pod install` | Dependency graph clean with 0 lockfile errors |
48
+ | Phase 2 -> Phase 3 | Compilation completed | `npm run build:mobile` | Binary generated with exit code 0 |
49
+ | Phase 3 -> Completion | Binary signed and verified | Binary size & signature audit | Target package bundle verified |
@@ -0,0 +1,65 @@
1
+ ---
2
+ name: "Product-Led Onboarding Funnel & Conversion Rate Optimization"
3
+ description: "Workflow for auditing user onboarding drop-off, designing activation experiments, optimizing signup flows, and engineering viral referral loops."
4
+ bundle: "product-led-growth"
5
+ estimatedDuration: "45-75m"
6
+ ---
7
+
8
+ # Workflow: Product-Led Onboarding Funnel & Conversion Rate Optimization
9
+
10
+ ## Overview & Scope
11
+ The Onboarding Funnel CRO workflow accelerates user activation and Product-Led Growth (PLG). It conducts funnel drop-off diagnostics, form friction reduction, interactive onboarding checklist deployment, time-to-value (TTV) optimization, and viral referral loop engineering.
12
+
13
+ ## Execution Flowchart
14
+ ```mermaid
15
+ graph TD
16
+ Start([Start Workflow]) --> P1[Phase 1: Funnel Diagnostic & Telemetry Audit]
17
+ P1 --> InputCheck{"Telemetry & Baseline Metrics Valid?"}
18
+ InputCheck -->|No| Abort1[Abort & Request Funnel Data]
19
+ InputCheck -->|Yes| P2[Phase 2: Onboarding Experimentation & Interaction Optimization]
20
+ P2 --> Gate1{"Verification Gate: Event Tracking & A/B Flags Pass?"}
21
+ Gate1 -->|Fail| Rollback[Execute Automated Rollback Protocol]
22
+ Rollback --> P2
23
+ Gate1 -->|Pass| P3[Phase 3: Telemetry Verification, SRM Audit & Rollout]
24
+ P3 --> Gate2{"Final Acceptance Gate Passed?"}
25
+ Gate2 -->|Fail| P3Fix[Remediate Funnel Code / Flags]
26
+ P3Fix --> P3
27
+ Gate2 -->|Pass| Done([Workflow Complete & Logged])
28
+ ```
29
+
30
+ ## Required Tool Inputs & Context
31
+ - Onboarding funnel step definitions (Signup -> Profile -> First Project -> Aha Moment -> Activation)
32
+ - Baseline conversion telemetry (step-by-step drop-off rates, time-to-value benchmarks)
33
+ - Feature flag / experimentation platform configuration (PostHog, LaunchDarkly, GrowthBook)
34
+ - Product onboarding UI component library (checklists, tooltips, empty states)
35
+
36
+ ## Phase 1: Funnel Diagnostic & Telemetry Audit
37
+ - Map user journey milestones from initial landing to core product activation.
38
+ - Analyze step-by-step drop-off metrics to identify primary conversion bottlenecks.
39
+ - Calculate baseline Time-to-Value (TTV) and identify friction points (unnecessary form fields, password friction, premature paywalls).
40
+ - Formulate CRO hypothesis: "By replacing [friction point] with [optimized interaction], activation rate will increase by [X]%".
41
+
42
+ ## Phase 2: Onboarding Experimentation & Interaction Optimization
43
+ - Design optimized challenger variant (frictionless OAuth/magic link, progressive profiling, interactive onboarding checklist).
44
+ - Pre-fill empty states with actionable starter templates to accelerate the "Aha!" moment.
45
+ - Integrate viral referral mechanics (team invite prompts, shared workspace links, gamified completion rewards).
46
+ - Configure A/B test feature flags with deterministic 50/50 user hashing.
47
+
48
+ ## Phase 3: Telemetry Verification, SRM Audit & Rollout
49
+ - Verify analytics event emission across all onboarding milestone steps.
50
+ - Execute Sample Ratio Mismatch (SRM) test to confirm unbiased 50/50 traffic split between control and challenger variants.
51
+ - Monitor error logs, user drop-offs, and completion rates in real time during initial rollout.
52
+ - Evaluate statistical significance (p < 0.05) once required sample size is reached.
53
+
54
+ ## Phase Transition Criteria & Deterministic Verification Gates
55
+ | Transition | Prerequisites | Verification Command / Gate | Success Criteria |
56
+ |---|---|---|---|
57
+ | Phase 1 -> Phase 2 | Tool inputs verified & environment ready | `node dist/cli.js doctor` | Doctor health check succeeds with 0 errors |
58
+ | Phase 2 -> Phase 3 | Execution steps complete | `npm test` | Onboarding test suite validates event tracking triggers and feature flag routing logic |
59
+ | Phase 3 -> Completion | Verification complete & artifacts signed off | `npm run build` | Frontend UI components and onboarding bundle compile without TypeScript errors |
60
+
61
+ ## Validation Checkpoints & Automated Rollback Protocols
62
+ - **Validation Checkpoint 1**: All onboarding milestone events fire consistently with valid user and workspace IDs.
63
+ - **Validation Checkpoint 2**: Sample Ratio Mismatch (SRM) chi-square test passes with p > 0.01, confirming unskewed variant distribution.
64
+ - **Validation Checkpoint 3**: Challenger variant demonstrates zero regression in critical registration flows.
65
+ - **Automated Rollback Protocol**: Automatically switch feature flag to 100% control variant and disable challenger flow if onboarding error rate spikes by > 2% or completion rate drops significantly during rollout.