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,132 @@
1
+ ---
2
+ name: database-design
3
+ description: Production-grade Database Design playbook for high-throughput transactional schemas, indexing, and migrations.
4
+ metadata:
5
+ author: "agents-united"
6
+ version: "2.0.0"
7
+ ---
8
+
9
+ # Relational & NoSQL Database Schema Design
10
+
11
+ ## Overview & Purpose
12
+ The Relational & NoSQL Database Schema Design skill provides a deterministic, battle-tested framework for executing database-design processes across the Agents United multi-agent ecosystem.
13
+
14
+ Following this skill ensures high quality, zero-regression execution, rigorous testing gates, and seamless cross-functional team alignment.
15
+
16
+ ## Execution Triggers & Prerequisites
17
+ ### Execution Triggers
18
+ - Direct request or workflow step invoking database-design.
19
+ - Auditing, implementing, or standardizing database-design procedures.
20
+ - Addressing technical debt, architectural reviews, or production readiness gates.
21
+ - Preparing pull requests or automated release validations.
22
+
23
+ ### Prerequisites
24
+ - Active project repository workspace with version control configured.
25
+ - Operational testing, typechecking, and build toolchains.
26
+ - Domain requirements, architectural constraints, or user stories defined.
27
+ - Clean git working tree before beginning execution.
28
+
29
+ ## Input & Output Requirements
30
+ ### Inputs
31
+ | Parameter | Type | Required | Description |
32
+ |---|---|---|---|
33
+ | `target_scope` | String | Yes | Target module, service, component, or file path |
34
+ | `config` | Object | Optional | Specific domain configurations, thresholds, and options |
35
+ | `output_dir` | Directory Path | Optional | Destination directory for generated artifacts and reports |
36
+ | `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation and high test coverage |
37
+
38
+ ### Outputs
39
+ | Artifact | Path / Format | Description |
40
+ |---|---|---|
41
+ | Specification Document | `docs/database-design/spec.md` | Full technical specification and architectural plan |
42
+ | Implementation Files | `src/database-design/*` | Production-ready source code, tests, and configurations |
43
+ | Execution Report | `reports/database-design/summary.json` | Verification metrics, test results, and audit summary |
44
+
45
+ ## Step-by-Step Execution Runbook
46
+
47
+ ### Phase 1: Entity-Relationship Modeling & Normalization
48
+ 1. Map business entities, cardinality (1:1, 1:N, N:M), and ownership relationships.
49
+ 2. Normalize relational schema to Third Normal Form (3NF) to eliminate data redundancy.
50
+ 3. Identify strategic denormalization opportunities for read-heavy query paths.
51
+ 4. Choose appropriate primary key strategy: UUIDv7 / ULID (distributed) vs BIGINT IDENTITY.
52
+ 5. Design foreign key constraints with explicit ON DELETE RESTRICT / CASCADE policies.
53
+
54
+ ### Phase 2: Index Strategy & Partitioning Architecture
55
+ 1. Analyze query access patterns (filter predicates, join columns, order-by clauses).
56
+ 2. Design composite B-tree indexes following Equality-Range-Sort (ESR) rule.
57
+ 3. Implement partial/filtered indexes for status flags (WHERE status = 'active').
58
+ 4. Configure range/hash partitioning on high-volume tables (>10M rows per month).
59
+ 5. Audit index overhead against write-amplification tradeoffs.
60
+
61
+ ### Phase 3: Migration Script Authoring & Versioning
62
+ 1. Write deterministic, bidirectional migration scripts (up.sql and down.sql).
63
+ 2. Wrap DDL operations in atomic transactions where supported by database engine.
64
+ 3. Use lock-free DDL patterns (e.g. CREATE INDEX CONCURRENTLY in PostgreSQL).
65
+ 4. Ensure zero-downtime expand-and-contract pattern for schema column renames/drops.
66
+ 5. Test migration rollback (down) in isolated staging environment.
67
+
68
+ ### Phase 4: Query Optimization & EXPLAIN ANALYZE Verification
69
+ 1. Execute EXPLAIN (ANALYZE, BUFFERS) on critical path database queries.
70
+ 2. Verify elimination of sequential table scans on multi-million row datasets.
71
+ 3. Verify connection pool sizing (HikariCP/pgpool) against database max connections.
72
+ 4. Set statement timeouts to prevent long-running runaway transactions.
73
+ 5. Audit query memory consumption during batch processing.
74
+
75
+ ### Phase 5: Data Integrity & Backup Validation
76
+ 1. Define database checkpointing and Point-In-Time-Recovery (PITR) policies.
77
+ 2. Implement automated data corruption and constraint integrity checks.
78
+ 3. Update ORM entity schema mappings (Prisma, TypeORM, Drizzle) and generate typings.
79
+ 4. Commit schema migrations to version control.
80
+ 5. Deploy migrations to production database cluster.
81
+
82
+ ## Code & Configuration Exemplars
83
+
84
+ ### Exemplar 1: Relational & NoSQL Database Schema Design Configuration & Specification
85
+ ```yaml
86
+ CREATE TABLE orders (
87
+ id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
88
+ tenant_id UUID NOT NULL REFERENCES tenants(id) ON DELETE RESTRICT,
89
+ customer_id UUID NOT NULL REFERENCES customers(id),
90
+ total_cents BIGINT NOT NULL CHECK (total_cents >= 0),
91
+ status VARCHAR(32) NOT NULL DEFAULT 'pending',
92
+ created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
93
+ updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
94
+ );
95
+ CREATE INDEX idx_orders_tenant_status_created ON orders (tenant_id, status, created_at DESC);
96
+ ```
97
+
98
+ ### Exemplar 2: Relational & NoSQL Database Schema Design TypeScript Type Contract
99
+ ```typescript
100
+ export interface MigrationStep {
101
+ version: number;
102
+ name: string;
103
+ up: string;
104
+ down: string;
105
+ transactional: boolean;
106
+ reversible: boolean;
107
+ }
108
+ ```
109
+
110
+ ## Edge Cases & Error Recovery Procedures
111
+
112
+ ### Scenario A: Validation Failure in Relational & NoSQL Database Schema Design
113
+ 1. **Diagnosis**: Static analysis, typechecking, or unit tests fail validation rules during execution.
114
+ 2. **Recovery Protocol**:
115
+ - Step 1: Inspect detailed error log output in test/build terminal.
116
+ - Step 2: Formulate targeted hypothesis and isolate failing line or assertion.
117
+ - Step 3: Implement surgical code fix and re-run verification suite.
118
+
119
+ ### Scenario B: Missing or Incompatible Dependency
120
+ 1. **Diagnosis**: Required toolchain binary or library dependency is missing from the environment.
121
+ 2. **Recovery Protocol**:
122
+ - Step 1: Verify `package.json` engine requirements and local environment versions.
123
+ - Step 2: Install required peer dependencies cleanly with lockfile sync.
124
+ - Step 3: Resume runbook from Phase 1.
125
+
126
+ ## Verification & Validation Checklist
127
+ - [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
128
+ - [ ] All 7 mandatory sections present with explicit headers.
129
+ - [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
130
+ - [ ] Code exemplars provided with valid syntax fencing.
131
+ - [ ] Zero dummy placeholder strings or unpopulated template markers present.
132
+ - [ ] Project build, test suite, and doctor check pass 100% cleanly.
@@ -1,13 +1,139 @@
1
1
  ---
2
2
  name: dependency-management
3
- description: Official Dependency Management skill for Agents United ecosystem providing runbooks and guidelines.
3
+ description: Production-grade Dependency Management playbook for secure supply-chain integrity, semver updates, and lockfile hygiene.
4
+ metadata:
5
+ author: "agents-united"
6
+ version: "2.0.0"
4
7
  ---
5
8
 
6
- # Dependency Management
9
+ # Dependency Management, Vulnerability Auditing & Upgrades
7
10
 
8
- This skill provides comprehensive instructions, runbooks, and guidelines for Dependency Management.
11
+ ## Overview & Purpose
12
+ The Dependency Management, Vulnerability Auditing & Upgrades skill provides a deterministic, battle-tested framework for executing dependency-management processes across the Agents United multi-agent ecosystem.
9
13
 
10
- ## Procedure & Guidelines
11
- 1. Review domain requirements and constraints.
12
- 2. Execute step-by-step procedures test-first.
13
- 3. Validate results against acceptance criteria.
14
+ Following this skill ensures high quality, zero-regression execution, rigorous testing gates, and seamless cross-functional team alignment.
15
+
16
+ ## Execution Triggers & Prerequisites
17
+ ### Execution Triggers
18
+ - Direct request or workflow step invoking dependency-management.
19
+ - Auditing, implementing, or standardizing dependency-management procedures.
20
+ - Addressing technical debt, architectural reviews, or production readiness gates.
21
+ - Preparing pull requests or automated release validations.
22
+
23
+ ### Prerequisites
24
+ - Active project repository workspace with version control configured.
25
+ - Operational testing, typechecking, and build toolchains.
26
+ - Domain requirements, architectural constraints, or user stories defined.
27
+ - Clean git working tree before beginning execution.
28
+
29
+ ## Input & Output Requirements
30
+ ### Inputs
31
+ | Parameter | Type | Required | Description |
32
+ |---|---|---|---|
33
+ | `target_scope` | String | Yes | Target module, service, component, or file path |
34
+ | `config` | Object | Optional | Specific domain configurations, thresholds, and options |
35
+ | `output_dir` | Directory Path | Optional | Destination directory for generated artifacts and reports |
36
+ | `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation and high test coverage |
37
+
38
+ ### Outputs
39
+ | Artifact | Path / Format | Description |
40
+ |---|---|---|
41
+ | Specification Document | `docs/dependency-management/spec.md` | Full technical specification and architectural plan |
42
+ | Implementation Files | `src/dependency-management/*` | Production-ready source code, tests, and configurations |
43
+ | Execution Report | `reports/dependency-management/summary.json` | Verification metrics, test results, and audit summary |
44
+
45
+ ## Step-by-Step Execution Runbook
46
+
47
+ ### Phase 1: Dependency Supply-Chain Audit
48
+ 1. Scan dependency tree for known CVEs using npm audit and Snyk/OSV scanners.
49
+ 2. Identify deprecated packages and unmaintained upstream repositories (>2 years inactive).
50
+ 3. Check for license compliance (MIT, Apache-2.0, BSD vs restrictive AGPL).
51
+ 4. Review direct vs transitive dependency graph depth and duplicate package instances.
52
+ 5. Generate dependency inventory report.
53
+
54
+ ### Phase 2: Outdated Package Assessment & Semver Planning
55
+ 1. Run npm outdated to list all packages with patch, minor, or major updates available.
56
+ 2. Categorize updates: Patch (bug fixes), Minor (features), Major (breaking changes).
57
+ 3. Review changelogs and GitHub release notes for breaking API changes and migration guides.
58
+ 4. Formulate staged upgrade batching plan (upgrade utility libs first, core frameworks last).
59
+ 5. Ensure isolated git branch for dependency updates.
60
+
61
+ ### Phase 3: Staged Upgrade & Lockfile Synchronization
62
+ 1. Execute atomic upgrades per package or group using npm install package@version.
63
+ 2. Verify package lockfile integrity (package-lock.json or pnpm-lock.yaml).
64
+ 3. Apply package overrides / resolutions for transitive security vulnerabilities where needed.
65
+ 4. Prune orphan packages using npm prune.
66
+ 5. Verify lockfile is strictly deterministic with reproducible builds.
67
+
68
+ ### Phase 4: Full Automated Regression Verification
69
+ 1. Run complete TypeScript typecheck (npm run typecheck) to detect API signature breaks.
70
+ 2. Run full unit and integration test suite (npm test).
71
+ 3. Execute production build (npm run build) and inspect output bundle size delta.
72
+ 4. Run end-to-end smoke tests against compiled distribution assets.
73
+ 5. Confirm zero build warnings or runtime deprecation notices.
74
+
75
+ ### Phase 5: Release Notes & CI Pipeline Enforcement
76
+ 1. Document upgraded package versions and security fixes in commit message.
77
+ 2. Configure Dependabot / Renovate automation rules for continuous dependency maintenance.
78
+ 3. Enforce CI check rejecting PRs with high/critical security vulnerabilities.
79
+ 4. Commit lockfile and package manifest changes.
80
+ 5. Merge dependency update pull request.
81
+
82
+ ## Code & Configuration Exemplars
83
+
84
+ ### Exemplar 1: Dependency Management, Vulnerability Auditing & Upgrades Configuration & Specification
85
+ ```yaml
86
+ // package.json engine and package overrides
87
+ {
88
+ "engines": {
89
+ "node": ">=24.0.0",
90
+ "npm": ">=10.0.0"
91
+ },
92
+ "overrides": {
93
+ "glob": "^11.0.0"
94
+ }
95
+ }
96
+ ```
97
+
98
+ ### Exemplar 2: Dependency Management, Vulnerability Auditing & Upgrades TypeScript Type Contract
99
+ ```typescript
100
+ export interface DependencyAuditResult {
101
+ vulnerabilities: {
102
+ critical: number;
103
+ high: number;
104
+ moderate: number;
105
+ low: number;
106
+ };
107
+ outdatedPackages: Array<{
108
+ name: string;
109
+ current: string;
110
+ wanted: string;
111
+ latest: string;
112
+ breaking: boolean;
113
+ }>;
114
+ }
115
+ ```
116
+
117
+ ## Edge Cases & Error Recovery Procedures
118
+
119
+ ### Scenario A: Validation Failure in Dependency Management, Vulnerability Auditing & Upgrades
120
+ 1. **Diagnosis**: Static analysis, typechecking, or unit tests fail validation rules during execution.
121
+ 2. **Recovery Protocol**:
122
+ - Step 1: Inspect detailed error log output in test/build terminal.
123
+ - Step 2: Formulate targeted hypothesis and isolate failing line or assertion.
124
+ - Step 3: Implement surgical code fix and re-run verification suite.
125
+
126
+ ### Scenario B: Missing or Incompatible Dependency
127
+ 1. **Diagnosis**: Required toolchain binary or library dependency is missing from the environment.
128
+ 2. **Recovery Protocol**:
129
+ - Step 1: Verify `package.json` engine requirements and local environment versions.
130
+ - Step 2: Install required peer dependencies cleanly with lockfile sync.
131
+ - Step 3: Resume runbook from Phase 1.
132
+
133
+ ## Verification & Validation Checklist
134
+ - [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
135
+ - [ ] All 7 mandatory sections present with explicit headers.
136
+ - [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
137
+ - [ ] Code exemplars provided with valid syntax fencing.
138
+ - [ ] Zero dummy placeholder strings or unpopulated template markers present.
139
+ - [ ] Project build, test suite, and doctor check pass 100% cleanly.
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: design-handoff-spec
3
+ description: Production-grade Design Handoff Spec playbook for design operations, UX systems, and growth strategy.
4
+ metadata:
5
+ author: "agents-united"
6
+ version: "2.0.0"
7
+ ---
8
+
9
+ # Design Handoff Spec
10
+
11
+ ## Overview & Purpose
12
+ The Design Handoff Spec skill provides a deterministic framework for executing design handoff spec 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 Design Handoff Spec tasks.
19
+ - Auditing existing product assets or workflows.
20
+ - Standardizing design-handoff-spec 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/design-handoff-spec/spec.md` | Full specification and guidelines document |
42
+ | Component / Asset Files | `src/design-handoff-spec/*` | Implemented design tokens, components, or campaign assets |
43
+ | Audit Report | `reports/design-handoff-spec/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/design-handoff-spec/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/design-handoff-spec/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/design-handoff-spec/ reports/design-handoff-spec/
98
+ git commit -m "feat(design-handoff-spec): implement Design Handoff Spec playbook artifacts"
99
+ ```
100
+ 4. Publish documentation for team review.
101
+
102
+ ## Code & Configuration Exemplars
103
+
104
+ ### Exemplar 1: Design Handoff Spec Configuration Specification
105
+ ```yaml
106
+ version: "2.0.0"
107
+ metadata:
108
+ skill: "design-handoff-spec"
109
+ author: "agents-united"
110
+ rules:
111
+ strictValidation: true
112
+ reporting:
113
+ format: "json"
114
+ output: "reports/design-handoff-spec/summary.json"
115
+ ```
116
+
117
+ ### Exemplar 2: Design Handoff Spec Helper Module
118
+ ```typescript
119
+ export function runDesignHandoffSpec(scope: string): boolean {
120
+ console.log('Running Design Handoff Spec on:', scope);
121
+ return true;
122
+ }
123
+ ```
124
+
125
+ ## Edge Cases & Error Recovery Procedures
126
+
127
+ ### Scenario A: Validation Failure in Design Handoff Spec
128
+ 1. **Diagnosis**: Specification or code asset fails validation rules in design-handoff-spec.
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 Design Handoff Spec
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: design-ops-workflow
3
+ description: Production-grade Design Ops Workflow playbook for design operations, UX systems, and growth strategy.
4
+ metadata:
5
+ author: "agents-united"
6
+ version: "2.0.0"
7
+ ---
8
+
9
+ # Design Ops Workflow
10
+
11
+ ## Overview & Purpose
12
+ The Design Ops Workflow skill provides a deterministic framework for executing design ops workflow 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 Design Ops Workflow tasks.
19
+ - Auditing existing product assets or workflows.
20
+ - Standardizing design-ops-workflow 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/design-ops-workflow/spec.md` | Full specification and guidelines document |
42
+ | Component / Asset Files | `src/design-ops-workflow/*` | Implemented design tokens, components, or campaign assets |
43
+ | Audit Report | `reports/design-ops-workflow/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/design-ops-workflow/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/design-ops-workflow/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/design-ops-workflow/ reports/design-ops-workflow/
98
+ git commit -m "feat(design-ops-workflow): implement Design Ops Workflow playbook artifacts"
99
+ ```
100
+ 4. Publish documentation for team review.
101
+
102
+ ## Code & Configuration Exemplars
103
+
104
+ ### Exemplar 1: Design Ops Workflow Configuration Specification
105
+ ```yaml
106
+ version: "2.0.0"
107
+ metadata:
108
+ skill: "design-ops-workflow"
109
+ author: "agents-united"
110
+ rules:
111
+ strictValidation: true
112
+ reporting:
113
+ format: "json"
114
+ output: "reports/design-ops-workflow/summary.json"
115
+ ```
116
+
117
+ ### Exemplar 2: Design Ops Workflow Helper Module
118
+ ```typescript
119
+ export function runDesignOpsWorkflow(scope: string): boolean {
120
+ console.log('Running Design Ops Workflow on:', scope);
121
+ return true;
122
+ }
123
+ ```
124
+
125
+ ## Edge Cases & Error Recovery Procedures
126
+
127
+ ### Scenario A: Validation Failure in Design Ops Workflow
128
+ 1. **Diagnosis**: Specification or code asset fails validation rules in design-ops-workflow.
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 Design Ops Workflow
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.