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
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: component-playground-setup
3
+ description: Production-grade Component Playground Setup playbook for design operations, UX systems, and growth strategy.
4
+ metadata:
5
+ author: "agents-united"
6
+ version: "2.0.0"
7
+ ---
8
+
9
+ # Component Playground Setup
10
+
11
+ ## Overview & Purpose
12
+ The Component Playground Setup skill provides a deterministic framework for executing component playground setup processes in modern software products.
13
+
14
+ Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
15
+
16
+ ## Execution Triggers & Prerequisites
17
+ ### Execution Triggers
18
+ - Direct request to execute Component Playground Setup tasks.
19
+ - Auditing existing product assets or workflows.
20
+ - Standardizing component-playground-setup procedures across team projects.
21
+ - Preparing design handoffs or growth campaign launches.
22
+
23
+ ### Prerequisites
24
+ - Project workspace configured with design system tokens or component libraries.
25
+ - Target UI design specification or growth experiment hypothesis.
26
+ - Testing and linting tools operational.
27
+ - Clean git working directory.
28
+
29
+ ## Input & Output Requirements
30
+ ### Inputs
31
+ | Parameter | Type | Required | Description |
32
+ |---|---|---|---|
33
+ | `target_scope` | String | Yes | Target UI component, page, or campaign scope |
34
+ | `config` | Object | Optional | Specific parameters and threshold configurations |
35
+ | `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
36
+ | `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
37
+
38
+ ### Outputs
39
+ | Artifact | Path / Format | Description |
40
+ |---|---|---|
41
+ | Specification Document | `docs/component-playground-setup/spec.md` | Full specification and guidelines document |
42
+ | Component / Asset Files | `src/component-playground-setup/*` | Implemented design tokens, components, or campaign assets |
43
+ | Audit Report | `reports/component-playground-setup/summary.json` | Health check and audit metric results |
44
+
45
+ ## Step-by-Step Execution Runbook
46
+
47
+ ### Phase 1: Pre-Execution Discovery & Workspace Analysis
48
+ 1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
49
+ ```bash
50
+ find src/ docs/ -maxdepth 3 -type f
51
+ ```
52
+ 2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
53
+ 3. Establish baseline quality metrics and target benchmarks.
54
+ 4. Verify working tree status to ensure clean git workspace.
55
+ ```bash
56
+ git status --short
57
+ ```
58
+ 5. Formulate initial execution plan.
59
+
60
+ ### Phase 2: Input Contract Validation & Strategy Selection
61
+ 1. Validate input parameters against technical feasibility and design system guidelines.
62
+ 2. Select implementation pattern matching component or campaign architecture.
63
+ 3. Establish verification rules and accessibility / conversion thresholds.
64
+ 4. Formulate atomic step-by-step execution sequence.
65
+ 5. Create temporary working directory if needed.
66
+
67
+ ### Phase 3: Core Step-by-Step Implementation Execution
68
+ 1. Author primary specification document at `docs/component-playground-setup/spec.md`.
69
+ 2. Generate code, token, or layout implementation files.
70
+ ```bash
71
+ npm run typecheck
72
+ ```
73
+ 3. Apply automated formatting and linting tools.
74
+ 4. Execute unit or visual regression tests.
75
+ ```bash
76
+ npm test
77
+ ```
78
+ 5. Refactor asset structure for optimal performance and maintainability.
79
+
80
+ ### Phase 4: Verification, Testing & Quality Gate Checking
81
+ 1. Run full project verification suite.
82
+ ```bash
83
+ npm run typecheck && npm test && npm run build
84
+ ```
85
+ 2. Verify zero lint errors, type warnings, or broken references.
86
+ 3. Execute CLI health doctor check.
87
+ ```bash
88
+ node dist/cli.js doctor
89
+ ```
90
+ 4. Assert all acceptance criteria are satisfied.
91
+
92
+ ### Phase 5: Post-Execution Cleanup & Artifact Generation
93
+ 1. Generate execution summary report at `reports/component-playground-setup/summary.md`.
94
+ 2. Clean up temporary build artifacts and scratch files.
95
+ 3. Commit generated files to git repository.
96
+ ```bash
97
+ git add docs/component-playground-setup/ reports/component-playground-setup/
98
+ git commit -m "feat(component-playground-setup): implement Component Playground Setup playbook artifacts"
99
+ ```
100
+ 4. Publish documentation for team review.
101
+
102
+ ## Code & Configuration Exemplars
103
+
104
+ ### Exemplar 1: Component Playground Setup Configuration Specification
105
+ ```yaml
106
+ version: "2.0.0"
107
+ metadata:
108
+ skill: "component-playground-setup"
109
+ author: "agents-united"
110
+ rules:
111
+ strictValidation: true
112
+ reporting:
113
+ format: "json"
114
+ output: "reports/component-playground-setup/summary.json"
115
+ ```
116
+
117
+ ### Exemplar 2: Component Playground Setup Helper Module
118
+ ```typescript
119
+ export function runComponentPlaygroundSetup(scope: string): boolean {
120
+ console.log('Running Component Playground Setup on:', scope);
121
+ return true;
122
+ }
123
+ ```
124
+
125
+ ## Edge Cases & Error Recovery Procedures
126
+
127
+ ### Scenario A: Validation Failure in Component Playground Setup
128
+ 1. **Diagnosis**: Specification or code asset fails validation rules in component-playground-setup.
129
+ 2. **Recovery Protocol**:
130
+ - Step 1: Inspect error log at reports directory.
131
+ - Step 2: Correct non-compliant syntax or structure.
132
+ - Step 3: Re-run verification pipeline.
133
+
134
+ ### Scenario B: Missing Resource for Component Playground Setup
135
+ 1. **Diagnosis**: Target design token or configuration asset missing from workspace.
136
+ 2. **Recovery Protocol**:
137
+ - Step 1: Generate baseline resource file from standard template.
138
+ - Step 2: Update configuration references.
139
+ - Step 3: Resume runbook execution.
140
+
141
+ ## Verification & Validation Checklist
142
+ - [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
143
+ - [ ] All 7 mandatory sections present with explicit headers.
144
+ - [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
145
+ - [ ] Code exemplars provided with valid syntax fencing.
146
+ - [ ] Zero dummy placeholder strings or unpopulated template markers present.
147
+ - [ ] Project build, test suite, and doctor check pass 100% cleanly.
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: content-calendar-strategy
3
+ description: Production-grade Content Calendar Strategy playbook for design operations, UX systems, and growth strategy.
4
+ metadata:
5
+ author: "agents-united"
6
+ version: "2.0.0"
7
+ ---
8
+
9
+ # Content Calendar Strategy
10
+
11
+ ## Overview & Purpose
12
+ The Content Calendar Strategy skill provides a deterministic framework for executing content calendar strategy processes in modern software products.
13
+
14
+ Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
15
+
16
+ ## Execution Triggers & Prerequisites
17
+ ### Execution Triggers
18
+ - Direct request to execute Content Calendar Strategy tasks.
19
+ - Auditing existing product assets or workflows.
20
+ - Standardizing content-calendar-strategy procedures across team projects.
21
+ - Preparing design handoffs or growth campaign launches.
22
+
23
+ ### Prerequisites
24
+ - Project workspace configured with design system tokens or component libraries.
25
+ - Target UI design specification or growth experiment hypothesis.
26
+ - Testing and linting tools operational.
27
+ - Clean git working directory.
28
+
29
+ ## Input & Output Requirements
30
+ ### Inputs
31
+ | Parameter | Type | Required | Description |
32
+ |---|---|---|---|
33
+ | `target_scope` | String | Yes | Target UI component, page, or campaign scope |
34
+ | `config` | Object | Optional | Specific parameters and threshold configurations |
35
+ | `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
36
+ | `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
37
+
38
+ ### Outputs
39
+ | Artifact | Path / Format | Description |
40
+ |---|---|---|
41
+ | Specification Document | `docs/content-calendar-strategy/spec.md` | Full specification and guidelines document |
42
+ | Component / Asset Files | `src/content-calendar-strategy/*` | Implemented design tokens, components, or campaign assets |
43
+ | Audit Report | `reports/content-calendar-strategy/summary.json` | Health check and audit metric results |
44
+
45
+ ## Step-by-Step Execution Runbook
46
+
47
+ ### Phase 1: Pre-Execution Discovery & Workspace Analysis
48
+ 1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
49
+ ```bash
50
+ find src/ docs/ -maxdepth 3 -type f
51
+ ```
52
+ 2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
53
+ 3. Establish baseline quality metrics and target benchmarks.
54
+ 4. Verify working tree status to ensure clean git workspace.
55
+ ```bash
56
+ git status --short
57
+ ```
58
+ 5. Formulate initial execution plan.
59
+
60
+ ### Phase 2: Input Contract Validation & Strategy Selection
61
+ 1. Validate input parameters against technical feasibility and design system guidelines.
62
+ 2. Select implementation pattern matching component or campaign architecture.
63
+ 3. Establish verification rules and accessibility / conversion thresholds.
64
+ 4. Formulate atomic step-by-step execution sequence.
65
+ 5. Create temporary working directory if needed.
66
+
67
+ ### Phase 3: Core Step-by-Step Implementation Execution
68
+ 1. Author primary specification document at `docs/content-calendar-strategy/spec.md`.
69
+ 2. Generate code, token, or layout implementation files.
70
+ ```bash
71
+ npm run typecheck
72
+ ```
73
+ 3. Apply automated formatting and linting tools.
74
+ 4. Execute unit or visual regression tests.
75
+ ```bash
76
+ npm test
77
+ ```
78
+ 5. Refactor asset structure for optimal performance and maintainability.
79
+
80
+ ### Phase 4: Verification, Testing & Quality Gate Checking
81
+ 1. Run full project verification suite.
82
+ ```bash
83
+ npm run typecheck && npm test && npm run build
84
+ ```
85
+ 2. Verify zero lint errors, type warnings, or broken references.
86
+ 3. Execute CLI health doctor check.
87
+ ```bash
88
+ node dist/cli.js doctor
89
+ ```
90
+ 4. Assert all acceptance criteria are satisfied.
91
+
92
+ ### Phase 5: Post-Execution Cleanup & Artifact Generation
93
+ 1. Generate execution summary report at `reports/content-calendar-strategy/summary.md`.
94
+ 2. Clean up temporary build artifacts and scratch files.
95
+ 3. Commit generated files to git repository.
96
+ ```bash
97
+ git add docs/content-calendar-strategy/ reports/content-calendar-strategy/
98
+ git commit -m "feat(content-calendar-strategy): implement Content Calendar Strategy playbook artifacts"
99
+ ```
100
+ 4. Publish documentation for team review.
101
+
102
+ ## Code & Configuration Exemplars
103
+
104
+ ### Exemplar 1: Content Calendar Strategy Configuration Specification
105
+ ```yaml
106
+ version: "2.0.0"
107
+ metadata:
108
+ skill: "content-calendar-strategy"
109
+ author: "agents-united"
110
+ rules:
111
+ strictValidation: true
112
+ reporting:
113
+ format: "json"
114
+ output: "reports/content-calendar-strategy/summary.json"
115
+ ```
116
+
117
+ ### Exemplar 2: Content Calendar Strategy Helper Module
118
+ ```typescript
119
+ export function runContentCalendarStrategy(scope: string): boolean {
120
+ console.log('Running Content Calendar Strategy on:', scope);
121
+ return true;
122
+ }
123
+ ```
124
+
125
+ ## Edge Cases & Error Recovery Procedures
126
+
127
+ ### Scenario A: Validation Failure in Content Calendar Strategy
128
+ 1. **Diagnosis**: Specification or code asset fails validation rules in content-calendar-strategy.
129
+ 2. **Recovery Protocol**:
130
+ - Step 1: Inspect error log at reports directory.
131
+ - Step 2: Correct non-compliant syntax or structure.
132
+ - Step 3: Re-run verification pipeline.
133
+
134
+ ### Scenario B: Missing Resource for Content Calendar Strategy
135
+ 1. **Diagnosis**: Target design token or configuration asset missing from workspace.
136
+ 2. **Recovery Protocol**:
137
+ - Step 1: Generate baseline resource file from standard template.
138
+ - Step 2: Update configuration references.
139
+ - Step 3: Resume runbook execution.
140
+
141
+ ## Verification & Validation Checklist
142
+ - [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
143
+ - [ ] All 7 mandatory sections present with explicit headers.
144
+ - [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
145
+ - [ ] Code exemplars provided with valid syntax fencing.
146
+ - [ ] Zero dummy placeholder strings or unpopulated template markers present.
147
+ - [ ] Project build, test suite, and doctor check pass 100% cleanly.
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: conversion-funnel-optimization
3
+ description: Production-grade Conversion Funnel Optimization playbook for design operations, UX systems, and growth strategy.
4
+ metadata:
5
+ author: "agents-united"
6
+ version: "2.0.0"
7
+ ---
8
+
9
+ # Conversion Funnel Optimization
10
+
11
+ ## Overview & Purpose
12
+ The Conversion Funnel Optimization skill provides a deterministic framework for executing conversion funnel optimization processes in modern software products.
13
+
14
+ Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
15
+
16
+ ## Execution Triggers & Prerequisites
17
+ ### Execution Triggers
18
+ - Direct request to execute Conversion Funnel Optimization tasks.
19
+ - Auditing existing product assets or workflows.
20
+ - Standardizing conversion-funnel-optimization procedures across team projects.
21
+ - Preparing design handoffs or growth campaign launches.
22
+
23
+ ### Prerequisites
24
+ - Project workspace configured with design system tokens or component libraries.
25
+ - Target UI design specification or growth experiment hypothesis.
26
+ - Testing and linting tools operational.
27
+ - Clean git working directory.
28
+
29
+ ## Input & Output Requirements
30
+ ### Inputs
31
+ | Parameter | Type | Required | Description |
32
+ |---|---|---|---|
33
+ | `target_scope` | String | Yes | Target UI component, page, or campaign scope |
34
+ | `config` | Object | Optional | Specific parameters and threshold configurations |
35
+ | `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
36
+ | `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
37
+
38
+ ### Outputs
39
+ | Artifact | Path / Format | Description |
40
+ |---|---|---|
41
+ | Specification Document | `docs/conversion-funnel-optimization/spec.md` | Full specification and guidelines document |
42
+ | Component / Asset Files | `src/conversion-funnel-optimization/*` | Implemented design tokens, components, or campaign assets |
43
+ | Audit Report | `reports/conversion-funnel-optimization/summary.json` | Health check and audit metric results |
44
+
45
+ ## Step-by-Step Execution Runbook
46
+
47
+ ### Phase 1: Pre-Execution Discovery & Workspace Analysis
48
+ 1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
49
+ ```bash
50
+ find src/ docs/ -maxdepth 3 -type f
51
+ ```
52
+ 2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
53
+ 3. Establish baseline quality metrics and target benchmarks.
54
+ 4. Verify working tree status to ensure clean git workspace.
55
+ ```bash
56
+ git status --short
57
+ ```
58
+ 5. Formulate initial execution plan.
59
+
60
+ ### Phase 2: Input Contract Validation & Strategy Selection
61
+ 1. Validate input parameters against technical feasibility and design system guidelines.
62
+ 2. Select implementation pattern matching component or campaign architecture.
63
+ 3. Establish verification rules and accessibility / conversion thresholds.
64
+ 4. Formulate atomic step-by-step execution sequence.
65
+ 5. Create temporary working directory if needed.
66
+
67
+ ### Phase 3: Core Step-by-Step Implementation Execution
68
+ 1. Author primary specification document at `docs/conversion-funnel-optimization/spec.md`.
69
+ 2. Generate code, token, or layout implementation files.
70
+ ```bash
71
+ npm run typecheck
72
+ ```
73
+ 3. Apply automated formatting and linting tools.
74
+ 4. Execute unit or visual regression tests.
75
+ ```bash
76
+ npm test
77
+ ```
78
+ 5. Refactor asset structure for optimal performance and maintainability.
79
+
80
+ ### Phase 4: Verification, Testing & Quality Gate Checking
81
+ 1. Run full project verification suite.
82
+ ```bash
83
+ npm run typecheck && npm test && npm run build
84
+ ```
85
+ 2. Verify zero lint errors, type warnings, or broken references.
86
+ 3. Execute CLI health doctor check.
87
+ ```bash
88
+ node dist/cli.js doctor
89
+ ```
90
+ 4. Assert all acceptance criteria are satisfied.
91
+
92
+ ### Phase 5: Post-Execution Cleanup & Artifact Generation
93
+ 1. Generate execution summary report at `reports/conversion-funnel-optimization/summary.md`.
94
+ 2. Clean up temporary build artifacts and scratch files.
95
+ 3. Commit generated files to git repository.
96
+ ```bash
97
+ git add docs/conversion-funnel-optimization/ reports/conversion-funnel-optimization/
98
+ git commit -m "feat(conversion-funnel-optimization): implement Conversion Funnel Optimization playbook artifacts"
99
+ ```
100
+ 4. Publish documentation for team review.
101
+
102
+ ## Code & Configuration Exemplars
103
+
104
+ ### Exemplar 1: Conversion Funnel Optimization Configuration Specification
105
+ ```yaml
106
+ version: "2.0.0"
107
+ metadata:
108
+ skill: "conversion-funnel-optimization"
109
+ author: "agents-united"
110
+ rules:
111
+ strictValidation: true
112
+ reporting:
113
+ format: "json"
114
+ output: "reports/conversion-funnel-optimization/summary.json"
115
+ ```
116
+
117
+ ### Exemplar 2: Conversion Funnel Optimization Helper Module
118
+ ```typescript
119
+ export function runConversionFunnelOptimization(scope: string): boolean {
120
+ console.log('Running Conversion Funnel Optimization on:', scope);
121
+ return true;
122
+ }
123
+ ```
124
+
125
+ ## Edge Cases & Error Recovery Procedures
126
+
127
+ ### Scenario A: Validation Failure in Conversion Funnel Optimization
128
+ 1. **Diagnosis**: Specification or code asset fails validation rules in conversion-funnel-optimization.
129
+ 2. **Recovery Protocol**:
130
+ - Step 1: Inspect error log at reports directory.
131
+ - Step 2: Correct non-compliant syntax or structure.
132
+ - Step 3: Re-run verification pipeline.
133
+
134
+ ### Scenario B: Missing Resource for Conversion Funnel Optimization
135
+ 1. **Diagnosis**: Target design token or configuration asset missing from workspace.
136
+ 2. **Recovery Protocol**:
137
+ - Step 1: Generate baseline resource file from standard template.
138
+ - Step 2: Update configuration references.
139
+ - Step 3: Resume runbook execution.
140
+
141
+ ## Verification & Validation Checklist
142
+ - [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
143
+ - [ ] All 7 mandatory sections present with explicit headers.
144
+ - [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
145
+ - [ ] Code exemplars provided with valid syntax fencing.
146
+ - [ ] Zero dummy placeholder strings or unpopulated template markers present.
147
+ - [ ] Project build, test suite, and doctor check pass 100% cleanly.
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: copywriting-frameworks
3
+ description: Production-grade Copywriting Frameworks playbook for design operations, UX systems, and growth strategy.
4
+ metadata:
5
+ author: "agents-united"
6
+ version: "2.0.0"
7
+ ---
8
+
9
+ # Copywriting Frameworks
10
+
11
+ ## Overview & Purpose
12
+ The Copywriting Frameworks skill provides a deterministic framework for executing copywriting frameworks processes in modern software products.
13
+
14
+ Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
15
+
16
+ ## Execution Triggers & Prerequisites
17
+ ### Execution Triggers
18
+ - Direct request to execute Copywriting Frameworks tasks.
19
+ - Auditing existing product assets or workflows.
20
+ - Standardizing copywriting-frameworks procedures across team projects.
21
+ - Preparing design handoffs or growth campaign launches.
22
+
23
+ ### Prerequisites
24
+ - Project workspace configured with design system tokens or component libraries.
25
+ - Target UI design specification or growth experiment hypothesis.
26
+ - Testing and linting tools operational.
27
+ - Clean git working directory.
28
+
29
+ ## Input & Output Requirements
30
+ ### Inputs
31
+ | Parameter | Type | Required | Description |
32
+ |---|---|---|---|
33
+ | `target_scope` | String | Yes | Target UI component, page, or campaign scope |
34
+ | `config` | Object | Optional | Specific parameters and threshold configurations |
35
+ | `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
36
+ | `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
37
+
38
+ ### Outputs
39
+ | Artifact | Path / Format | Description |
40
+ |---|---|---|
41
+ | Specification Document | `docs/copywriting-frameworks/spec.md` | Full specification and guidelines document |
42
+ | Component / Asset Files | `src/copywriting-frameworks/*` | Implemented design tokens, components, or campaign assets |
43
+ | Audit Report | `reports/copywriting-frameworks/summary.json` | Health check and audit metric results |
44
+
45
+ ## Step-by-Step Execution Runbook
46
+
47
+ ### Phase 1: Pre-Execution Discovery & Workspace Analysis
48
+ 1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
49
+ ```bash
50
+ find src/ docs/ -maxdepth 3 -type f
51
+ ```
52
+ 2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
53
+ 3. Establish baseline quality metrics and target benchmarks.
54
+ 4. Verify working tree status to ensure clean git workspace.
55
+ ```bash
56
+ git status --short
57
+ ```
58
+ 5. Formulate initial execution plan.
59
+
60
+ ### Phase 2: Input Contract Validation & Strategy Selection
61
+ 1. Validate input parameters against technical feasibility and design system guidelines.
62
+ 2. Select implementation pattern matching component or campaign architecture.
63
+ 3. Establish verification rules and accessibility / conversion thresholds.
64
+ 4. Formulate atomic step-by-step execution sequence.
65
+ 5. Create temporary working directory if needed.
66
+
67
+ ### Phase 3: Core Step-by-Step Implementation Execution
68
+ 1. Author primary specification document at `docs/copywriting-frameworks/spec.md`.
69
+ 2. Generate code, token, or layout implementation files.
70
+ ```bash
71
+ npm run typecheck
72
+ ```
73
+ 3. Apply automated formatting and linting tools.
74
+ 4. Execute unit or visual regression tests.
75
+ ```bash
76
+ npm test
77
+ ```
78
+ 5. Refactor asset structure for optimal performance and maintainability.
79
+
80
+ ### Phase 4: Verification, Testing & Quality Gate Checking
81
+ 1. Run full project verification suite.
82
+ ```bash
83
+ npm run typecheck && npm test && npm run build
84
+ ```
85
+ 2. Verify zero lint errors, type warnings, or broken references.
86
+ 3. Execute CLI health doctor check.
87
+ ```bash
88
+ node dist/cli.js doctor
89
+ ```
90
+ 4. Assert all acceptance criteria are satisfied.
91
+
92
+ ### Phase 5: Post-Execution Cleanup & Artifact Generation
93
+ 1. Generate execution summary report at `reports/copywriting-frameworks/summary.md`.
94
+ 2. Clean up temporary build artifacts and scratch files.
95
+ 3. Commit generated files to git repository.
96
+ ```bash
97
+ git add docs/copywriting-frameworks/ reports/copywriting-frameworks/
98
+ git commit -m "feat(copywriting-frameworks): implement Copywriting Frameworks playbook artifacts"
99
+ ```
100
+ 4. Publish documentation for team review.
101
+
102
+ ## Code & Configuration Exemplars
103
+
104
+ ### Exemplar 1: Copywriting Frameworks Configuration Specification
105
+ ```yaml
106
+ version: "2.0.0"
107
+ metadata:
108
+ skill: "copywriting-frameworks"
109
+ author: "agents-united"
110
+ rules:
111
+ strictValidation: true
112
+ reporting:
113
+ format: "json"
114
+ output: "reports/copywriting-frameworks/summary.json"
115
+ ```
116
+
117
+ ### Exemplar 2: Copywriting Frameworks Helper Module
118
+ ```typescript
119
+ export function runCopywritingFrameworks(scope: string): boolean {
120
+ console.log('Running Copywriting Frameworks on:', scope);
121
+ return true;
122
+ }
123
+ ```
124
+
125
+ ## Edge Cases & Error Recovery Procedures
126
+
127
+ ### Scenario A: Validation Failure in Copywriting Frameworks
128
+ 1. **Diagnosis**: Specification or code asset fails validation rules in copywriting-frameworks.
129
+ 2. **Recovery Protocol**:
130
+ - Step 1: Inspect error log at reports directory.
131
+ - Step 2: Correct non-compliant syntax or structure.
132
+ - Step 3: Re-run verification pipeline.
133
+
134
+ ### Scenario B: Missing Resource for Copywriting Frameworks
135
+ 1. **Diagnosis**: Target design token or configuration asset missing from workspace.
136
+ 2. **Recovery Protocol**:
137
+ - Step 1: Generate baseline resource file from standard template.
138
+ - Step 2: Update configuration references.
139
+ - Step 3: Resume runbook execution.
140
+
141
+ ## Verification & Validation Checklist
142
+ - [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
143
+ - [ ] All 7 mandatory sections present with explicit headers.
144
+ - [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
145
+ - [ ] Code exemplars provided with valid syntax fencing.
146
+ - [ ] Zero dummy placeholder strings or unpopulated template markers present.
147
+ - [ ] Project build, test suite, and doctor check pass 100% cleanly.