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.
- package/LICENSE +21 -0
- package/README.md +673 -0
- package/dist/cli.d.ts +5 -0
- package/dist/cli.js +4789 -0
- package/dist/cli.js.map +1 -0
- package/package.json +77 -0
- package/registry/agents/orchestrator-business.md +188 -0
- package/registry/agents/orchestrator-design.md +168 -0
- package/registry/agents/orchestrator-engineering.md +183 -0
- package/registry/agents/orchestrator-marketing.md +228 -0
- package/registry/agents/orchestrator-research.md +196 -0
- package/registry/agents/orchestrator-security.md +190 -0
- package/registry/agents/orchestrator-system-architecture.md +171 -0
- package/registry/agents/orchestrator-universal.md +168 -0
- package/registry/agents/subagent-accessibility-lead.md +47 -0
- package/registry/agents/subagent-ai-model-architect.md +97 -0
- package/registry/agents/subagent-android-architect.md +47 -0
- package/registry/agents/subagent-appsec-penetration-tester.md +189 -0
- package/registry/agents/subagent-backend-architect.md +360 -0
- package/registry/agents/subagent-business-panel-experts.md +126 -0
- package/registry/agents/subagent-cloud-infrastructure-architect.md +126 -0
- package/registry/agents/subagent-cloud-security-architect.md +221 -0
- package/registry/agents/subagent-code-reviewer.md +193 -0
- package/registry/agents/subagent-compliance-grc-specialist.md +147 -0
- package/registry/agents/subagent-cross-platform-specialist.md +47 -0
- package/registry/agents/subagent-data-engineer.md +46 -0
- package/registry/agents/subagent-database-administrator.md +141 -0
- package/registry/agents/subagent-deep-research.md +94 -0
- package/registry/agents/subagent-design-ops-lead.md +121 -0
- package/registry/agents/subagent-design-researcher.md +133 -0
- package/registry/agents/subagent-design-systems-architect.md +134 -0
- package/registry/agents/subagent-designer-toolkit-expert.md +363 -0
- package/registry/agents/subagent-devops-engineer.md +423 -0
- package/registry/agents/subagent-distributed-systems-architect.md +47 -0
- package/registry/agents/subagent-e2e-tester.md +60 -0
- package/registry/agents/subagent-financial-analyst.md +119 -0
- package/registry/agents/subagent-finops-cost-engineer.md +98 -0
- package/registry/agents/subagent-frontend-architect.md +368 -0
- package/registry/agents/subagent-interaction-designer.md +302 -0
- package/registry/agents/subagent-ios-architect.md +46 -0
- package/registry/agents/subagent-legal-contract-analyst.md +108 -0
- package/registry/agents/subagent-lifecycle-email-specialist.md +46 -0
- package/registry/agents/subagent-literature-patent-analyst.md +78 -0
- package/registry/agents/subagent-market-intelligence-analyst.md +110 -0
- package/registry/agents/subagent-marketing-campaign-specialist.md +80 -0
- package/registry/agents/subagent-marketing-content-strategist.md +184 -0
- package/registry/agents/subagent-marketing-conversion-specialist.md +79 -0
- package/registry/agents/subagent-marketing-creative-designer.md +93 -0
- package/registry/agents/subagent-marketing-growth-strategist.md +137 -0
- package/registry/agents/subagent-ml-platform-engineer.md +95 -0
- package/registry/agents/subagent-operations-strategist.md +85 -0
- package/registry/agents/subagent-paid-acquisition-specialist.md +47 -0
- package/registry/agents/subagent-plg-strategist.md +46 -0
- package/registry/agents/subagent-prototype-tester.md +140 -0
- package/registry/agents/subagent-qa-automation-lead.md +63 -0
- package/registry/agents/subagent-repo-index.md +180 -0
- package/registry/agents/subagent-security-engineer.md +134 -0
- package/registry/agents/subagent-seo-specialist.md +46 -0
- package/registry/agents/subagent-socratic-mentor.md +105 -0
- package/registry/agents/subagent-statistical-analyst.md +132 -0
- package/registry/agents/subagent-sysops-sre-lead.md +84 -0
- package/registry/agents/subagent-system-architect.md +122 -0
- package/registry/agents/subagent-ui-designer.md +149 -0
- package/registry/agents/subagent-ux-strategist.md +88 -0
- package/registry/bundles.json +1386 -0
- package/registry/rules/AGENTS.md +41 -0
- package/registry/rules/CLAUDE.md +12 -0
- package/registry/rules/CURSOR.md +12 -0
- package/registry/rules/GEMINI.md +41 -0
- package/registry/rules/clean-code-and-architecture.md +25 -0
- package/registry/rules/domain-modeling-and-adr.md +27 -0
- package/registry/rules/git-guardrails.md +19 -0
- package/registry/rules/multi-agent-coordination.md +33 -0
- package/registry/rules/quality-aesthetics-accessibility.md +29 -0
- package/registry/rules/skill-attribution.md +27 -0
- package/registry/rules/test-driven-development.md +41 -0
- package/registry/skills/ab-test-setup/SKILL.md +150 -0
- package/registry/skills/accessibility-audit/SKILL.md +150 -0
- package/registry/skills/ad-attribution-modeling/SKILL.md +206 -0
- package/registry/skills/ad-creative-design/SKILL.md +27 -0
- package/registry/skills/ai-prototype-refactoring/SKILL.md +29 -0
- package/registry/skills/architecture-design/SKILL.md +141 -0
- package/registry/skills/azure-infrastructure-bicep/SKILL.md +28 -0
- package/registry/skills/backend-api-design/SKILL.md +151 -0
- package/registry/skills/chaos-engineering/SKILL.md +41 -0
- package/registry/skills/churn-prevention-playbook/SKILL.md +181 -0
- package/registry/skills/ci-cd-pipeline-automation/SKILL.md +40 -0
- package/registry/skills/clickable-prototype-spec/SKILL.md +150 -0
- package/registry/skills/code-refactoring/SKILL.md +135 -0
- package/registry/skills/component-library-management/SKILL.md +150 -0
- package/registry/skills/component-playground-setup/SKILL.md +150 -0
- package/registry/skills/content-calendar-strategy/SKILL.md +150 -0
- package/registry/skills/conversion-funnel-optimization/SKILL.md +150 -0
- package/registry/skills/copywriting-frameworks/SKILL.md +150 -0
- package/registry/skills/database-design/SKILL.md +135 -0
- package/registry/skills/dependency-management/SKILL.md +142 -0
- package/registry/skills/design-handoff-spec/SKILL.md +150 -0
- package/registry/skills/design-ops-workflow/SKILL.md +150 -0
- package/registry/skills/design-system-governance/SKILL.md +150 -0
- package/registry/skills/design-system-tokens/SKILL.md +150 -0
- package/registry/skills/design-tokens-management/SKILL.md +150 -0
- package/registry/skills/design-version-control/SKILL.md +150 -0
- package/registry/skills/diagnosing-bugs/SKILL.md +45 -0
- package/registry/skills/docker-deployment/SKILL.md +144 -0
- package/registry/skills/domain-modeling/SKILL.md +52 -0
- package/registry/skills/email-drip-sequences/SKILL.md +181 -0
- package/registry/skills/email-marketing-automation/SKILL.md +150 -0
- package/registry/skills/finishing-a-development-branch/SKILL.md +132 -0
- package/registry/skills/frontend-component-design/SKILL.md +153 -0
- package/registry/skills/git-guardrails/SKILL.md +41 -0
- package/registry/skills/google-ads-optimization/SKILL.md +27 -0
- package/registry/skills/graphql-schema-design/SKILL.md +146 -0
- package/registry/skills/grill-me/SKILL.md +57 -0
- package/registry/skills/grill-with-docs/SKILL.md +84 -0
- package/registry/skills/growth-experiment-design/SKILL.md +150 -0
- package/registry/skills/handoff/SKILL.md +44 -0
- package/registry/skills/hf-model-evaluation/SKILL.md +84 -0
- package/registry/skills/interaction-pattern-library/SKILL.md +150 -0
- package/registry/skills/interactive-prototype-builder/SKILL.md +157 -0
- package/registry/skills/local-llm-inference/SKILL.md +77 -0
- package/registry/skills/maestro-mobile-testing/SKILL.md +40 -0
- package/registry/skills/marketing-creative-design/SKILL.md +186 -0
- package/registry/skills/mcp-setup/SKILL.md +370 -0
- package/registry/skills/meta-ad-creative-testing/SKILL.md +26 -0
- package/registry/skills/micro-interaction-design/SKILL.md +150 -0
- package/registry/skills/microservices-architecture/SKILL.md +141 -0
- package/registry/skills/mobile-android-design/SKILL.md +40 -0
- package/registry/skills/mobile-first-design/SKILL.md +150 -0
- package/registry/skills/mobile-ios-design/SKILL.md +40 -0
- package/registry/skills/mobile-platform-offline-validate/SKILL.md +41 -0
- package/registry/skills/modal-serverless-python/SKILL.md +81 -0
- package/registry/skills/onboarding-cro/SKILL.md +185 -0
- package/registry/skills/paid-acquisition-ppc/SKILL.md +171 -0
- package/registry/skills/performance-optimization/SKILL.md +141 -0
- package/registry/skills/playwright-best-practices/SKILL.md +39 -0
- package/registry/skills/product-launch-playbook/SKILL.md +150 -0
- package/registry/skills/programmatic-seo/SKILL.md +213 -0
- package/registry/skills/rag-vector-pipeline/SKILL.md +84 -0
- package/registry/skills/react-best-practices/SKILL.md +40 -0
- package/registry/skills/receiving-code-review/SKILL.md +130 -0
- package/registry/skills/replicate-model-inference/SKILL.md +76 -0
- package/registry/skills/requesting-code-review/SKILL.md +137 -0
- package/registry/skills/responsive-design-audit/SKILL.md +150 -0
- package/registry/skills/runpod-gpu-orchestration/SKILL.md +85 -0
- package/registry/skills/schema-markup-strategy/SKILL.md +194 -0
- package/registry/skills/security-audit/SKILL.md +139 -0
- package/registry/skills/seo-audit/SKILL.md +150 -0
- package/registry/skills/signup-flow-cro/SKILL.md +150 -0
- package/registry/skills/social-media-campaign/SKILL.md +150 -0
- package/registry/skills/state-driven-ui-animation/SKILL.md +150 -0
- package/registry/skills/subagent-driven-development/SKILL.md +135 -0
- package/registry/skills/supabase-backend-architecture/SKILL.md +28 -0
- package/registry/skills/systematic-debugging/SKILL.md +138 -0
- package/registry/skills/technical-documentation/SKILL.md +136 -0
- package/registry/skills/technical-seo-audit/SKILL.md +27 -0
- package/registry/skills/telemetry-monitoring/SKILL.md +40 -0
- package/registry/skills/test-driven-development/SKILL.md +135 -0
- package/registry/skills/to-spec/SKILL.md +48 -0
- package/registry/skills/to-tickets/SKILL.md +47 -0
- package/registry/skills/turso-distributed-sqlite/SKILL.md +27 -0
- package/registry/skills/ui-component-spec/SKILL.md +150 -0
- package/registry/skills/usability-testing-protocol/SKILL.md +150 -0
- package/registry/skills/user-flow-mapping/SKILL.md +150 -0
- package/registry/skills/user-journey-mapping/SKILL.md +150 -0
- package/registry/skills/vector-database-design/SKILL.md +84 -0
- package/registry/skills/vercel-deploy-best-practices/SKILL.md +28 -0
- package/registry/skills/viral-referral-loops/SKILL.md +209 -0
- package/registry/workflows/workflow-agency-ad-creative-sprint.md +50 -0
- package/registry/workflows/workflow-agency-brand-design-system.md +50 -0
- package/registry/workflows/workflow-agency-client-pitch-proposal.md +50 -0
- package/registry/workflows/workflow-agency-cro-funnel-teardown.md +50 -0
- package/registry/workflows/workflow-agency-full-campaign.md +58 -0
- package/registry/workflows/workflow-agency-seo-content-engine.md +50 -0
- package/registry/workflows/workflow-analyze.md +60 -0
- package/registry/workflows/workflow-api-contract-design.md +48 -0
- package/registry/workflows/workflow-app-store-release.md +48 -0
- package/registry/workflows/workflow-brainstorm.md +60 -0
- package/registry/workflows/workflow-build.md +60 -0
- package/registry/workflows/workflow-business-panel.md +60 -0
- package/registry/workflows/workflow-cleanup.md +60 -0
- package/registry/workflows/workflow-deploy-staging.md +49 -0
- package/registry/workflows/workflow-design-code.md +60 -0
- package/registry/workflows/workflow-design-ops--handoff.md +60 -0
- package/registry/workflows/workflow-design-ops--plan-sprint.md +60 -0
- package/registry/workflows/workflow-design-ops--setup-workflow.md +60 -0
- package/registry/workflows/workflow-design-orchestrate.md +60 -0
- package/registry/workflows/workflow-design-systems--audit-system.md +60 -0
- package/registry/workflows/workflow-design-systems--create-component.md +60 -0
- package/registry/workflows/workflow-design-systems--tokenize.md +60 -0
- package/registry/workflows/workflow-diagnose.md +45 -0
- package/registry/workflows/workflow-e2e-testing.md +49 -0
- package/registry/workflows/workflow-email-drip-sequence.md +65 -0
- package/registry/workflows/workflow-estimate.md +60 -0
- package/registry/workflows/workflow-explain.md +60 -0
- package/registry/workflows/workflow-frontend-audit.md +49 -0
- package/registry/workflows/workflow-git.md +60 -0
- package/registry/workflows/workflow-grill.md +51 -0
- package/registry/workflows/workflow-implement.md +61 -0
- package/registry/workflows/workflow-incident-triage.md +49 -0
- package/registry/workflows/workflow-interaction-design--design-interaction.md +60 -0
- package/registry/workflows/workflow-interaction-design--error-flow.md +60 -0
- package/registry/workflows/workflow-interaction-design--map-states.md +60 -0
- package/registry/workflows/workflow-marketing-audit.md +60 -0
- package/registry/workflows/workflow-marketing-campaign-builder.md +60 -0
- package/registry/workflows/workflow-marketing-content-pipeline.md +60 -0
- package/registry/workflows/workflow-marketing-growth-experiment.md +60 -0
- package/registry/workflows/workflow-marketing-launch.md +60 -0
- package/registry/workflows/workflow-marketing-panel.md +60 -0
- package/registry/workflows/workflow-ml-eval.md +51 -0
- package/registry/workflows/workflow-mobile-build.md +49 -0
- package/registry/workflows/workflow-onboarding-funnel-cro.md +65 -0
- package/registry/workflows/workflow-paid-acquisition-campaign.md +65 -0
- package/registry/workflows/workflow-paid-campaign-launch.md +47 -0
- package/registry/workflows/workflow-plan.md +60 -0
- package/registry/workflows/workflow-prototyping-testing--evaluate.md +60 -0
- package/registry/workflows/workflow-prototyping-testing--experiment.md +60 -0
- package/registry/workflows/workflow-prototyping-testing--prototype-plan.md +60 -0
- package/registry/workflows/workflow-prototyping-testing--test-plan.md +60 -0
- package/registry/workflows/workflow-rag-pipeline-deploy.md +53 -0
- package/registry/workflows/workflow-recommend.md +60 -0
- package/registry/workflows/workflow-research.md +60 -0
- package/registry/workflows/workflow-review.md +60 -0
- package/registry/workflows/workflow-seo-audit-pipeline.md +47 -0
- package/registry/workflows/workflow-seo-content-pipeline.md +65 -0
- package/registry/workflows/workflow-serverless-gpu-deploy.md +52 -0
- package/registry/workflows/workflow-spec-panel.md +60 -0
- package/registry/workflows/workflow-spec.md +44 -0
- package/registry/workflows/workflow-test.md +60 -0
- package/registry/workflows/workflow-troubleshoot.md +60 -0
- package/registry/workflows/workflow-ui-design--color-palette.md +60 -0
- package/registry/workflows/workflow-ui-design--design-screen.md +60 -0
- package/registry/workflows/workflow-ui-design--responsive-audit.md +60 -0
- package/registry/workflows/workflow-ui-design--type-system.md +60 -0
- package/registry/workflows/workflow-ux-strategy--benchmark.md +60 -0
- package/registry/workflows/workflow-ux-strategy--frame-problem.md +60 -0
- package/registry/workflows/workflow-ux-strategy--strategize.md +60 -0
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: design-system-governance
|
|
3
|
+
description: Production-grade Design System Governance playbook for design
|
|
4
|
+
operations, UX systems, and growth strategy.
|
|
5
|
+
metadata:
|
|
6
|
+
author: agents-united
|
|
7
|
+
version: 2.0.0
|
|
8
|
+
icon: ⚖️
|
|
9
|
+
disable-slash-command: true
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Design System Governance
|
|
13
|
+
|
|
14
|
+
## Overview & Purpose
|
|
15
|
+
The Design System Governance skill provides a deterministic framework for executing design system governance processes in modern software products.
|
|
16
|
+
|
|
17
|
+
Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
|
|
18
|
+
|
|
19
|
+
## Execution Triggers & Prerequisites
|
|
20
|
+
### Execution Triggers
|
|
21
|
+
- Direct request to execute Design System Governance tasks.
|
|
22
|
+
- Auditing existing product assets or workflows.
|
|
23
|
+
- Standardizing design-system-governance procedures across team projects.
|
|
24
|
+
- Preparing design handoffs or growth campaign launches.
|
|
25
|
+
|
|
26
|
+
### Prerequisites
|
|
27
|
+
- Project workspace configured with design system tokens or component libraries.
|
|
28
|
+
- Target UI design specification or growth experiment hypothesis.
|
|
29
|
+
- Testing and linting tools operational.
|
|
30
|
+
- Clean git working directory.
|
|
31
|
+
|
|
32
|
+
## Input & Output Requirements
|
|
33
|
+
### Inputs
|
|
34
|
+
| Parameter | Type | Required | Description |
|
|
35
|
+
|---|---|---|---|
|
|
36
|
+
| `target_scope` | String | Yes | Target UI component, page, or campaign scope |
|
|
37
|
+
| `config` | Object | Optional | Specific parameters and threshold configurations |
|
|
38
|
+
| `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
|
|
39
|
+
| `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
|
|
40
|
+
|
|
41
|
+
### Outputs
|
|
42
|
+
| Artifact | Path / Format | Description |
|
|
43
|
+
|---|---|---|
|
|
44
|
+
| Specification Document | `docs/design-system-governance/spec.md` | Full specification and guidelines document |
|
|
45
|
+
| Component / Asset Files | `src/design-system-governance/*` | Implemented design tokens, components, or campaign assets |
|
|
46
|
+
| Audit Report | `reports/design-system-governance/summary.json` | Health check and audit metric results |
|
|
47
|
+
|
|
48
|
+
## Step-by-Step Execution Runbook
|
|
49
|
+
|
|
50
|
+
### Phase 1: Pre-Execution Discovery & Workspace Analysis
|
|
51
|
+
1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
|
|
52
|
+
```bash
|
|
53
|
+
find src/ docs/ -maxdepth 3 -type f
|
|
54
|
+
```
|
|
55
|
+
2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
|
|
56
|
+
3. Establish baseline quality metrics and target benchmarks.
|
|
57
|
+
4. Verify working tree status to ensure clean git workspace.
|
|
58
|
+
```bash
|
|
59
|
+
git status --short
|
|
60
|
+
```
|
|
61
|
+
5. Formulate initial execution plan.
|
|
62
|
+
|
|
63
|
+
### Phase 2: Input Contract Validation & Strategy Selection
|
|
64
|
+
1. Validate input parameters against technical feasibility and design system guidelines.
|
|
65
|
+
2. Select implementation pattern matching component or campaign architecture.
|
|
66
|
+
3. Establish verification rules and accessibility / conversion thresholds.
|
|
67
|
+
4. Formulate atomic step-by-step execution sequence.
|
|
68
|
+
5. Create temporary working directory if needed.
|
|
69
|
+
|
|
70
|
+
### Phase 3: Core Step-by-Step Implementation Execution
|
|
71
|
+
1. Author primary specification document at `docs/design-system-governance/spec.md`.
|
|
72
|
+
2. Generate code, token, or layout implementation files.
|
|
73
|
+
```bash
|
|
74
|
+
npm run typecheck
|
|
75
|
+
```
|
|
76
|
+
3. Apply automated formatting and linting tools.
|
|
77
|
+
4. Execute unit or visual regression tests.
|
|
78
|
+
```bash
|
|
79
|
+
npm test
|
|
80
|
+
```
|
|
81
|
+
5. Refactor asset structure for optimal performance and maintainability.
|
|
82
|
+
|
|
83
|
+
### Phase 4: Verification, Testing & Quality Gate Checking
|
|
84
|
+
1. Run full project verification suite.
|
|
85
|
+
```bash
|
|
86
|
+
npm run typecheck && npm test && npm run build
|
|
87
|
+
```
|
|
88
|
+
2. Verify zero lint errors, type warnings, or broken references.
|
|
89
|
+
3. Execute CLI health doctor check.
|
|
90
|
+
```bash
|
|
91
|
+
node dist/cli.js doctor
|
|
92
|
+
```
|
|
93
|
+
4. Assert all acceptance criteria are satisfied.
|
|
94
|
+
|
|
95
|
+
### Phase 5: Post-Execution Cleanup & Artifact Generation
|
|
96
|
+
1. Generate execution summary report at `reports/design-system-governance/summary.md`.
|
|
97
|
+
2. Clean up temporary build artifacts and scratch files.
|
|
98
|
+
3. Commit generated files to git repository.
|
|
99
|
+
```bash
|
|
100
|
+
git add docs/design-system-governance/ reports/design-system-governance/
|
|
101
|
+
git commit -m "feat(design-system-governance): implement Design System Governance playbook artifacts"
|
|
102
|
+
```
|
|
103
|
+
4. Publish documentation for team review.
|
|
104
|
+
|
|
105
|
+
## Code & Configuration Exemplars
|
|
106
|
+
|
|
107
|
+
### Exemplar 1: Design System Governance Configuration Specification
|
|
108
|
+
```yaml
|
|
109
|
+
version: "2.0.0"
|
|
110
|
+
metadata:
|
|
111
|
+
skill: "design-system-governance"
|
|
112
|
+
author: "agents-united"
|
|
113
|
+
rules:
|
|
114
|
+
strictValidation: true
|
|
115
|
+
reporting:
|
|
116
|
+
format: "json"
|
|
117
|
+
output: "reports/design-system-governance/summary.json"
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Exemplar 2: Design System Governance Helper Module
|
|
121
|
+
```typescript
|
|
122
|
+
export function runDesignSystemGovernance(scope: string): boolean {
|
|
123
|
+
console.log('Running Design System Governance on:', scope);
|
|
124
|
+
return true;
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## Edge Cases & Error Recovery Procedures
|
|
129
|
+
|
|
130
|
+
### Scenario A: Validation Failure in Design System Governance
|
|
131
|
+
1. **Diagnosis**: Specification or code asset fails validation rules in design-system-governance.
|
|
132
|
+
2. **Recovery Protocol**:
|
|
133
|
+
- Step 1: Inspect error log at reports directory.
|
|
134
|
+
- Step 2: Correct non-compliant syntax or structure.
|
|
135
|
+
- Step 3: Re-run verification pipeline.
|
|
136
|
+
|
|
137
|
+
### Scenario B: Missing Resource for Design System Governance
|
|
138
|
+
1. **Diagnosis**: Target design token or configuration asset missing from workspace.
|
|
139
|
+
2. **Recovery Protocol**:
|
|
140
|
+
- Step 1: Generate baseline resource file from standard template.
|
|
141
|
+
- Step 2: Update configuration references.
|
|
142
|
+
- Step 3: Resume runbook execution.
|
|
143
|
+
|
|
144
|
+
## Verification & Validation Checklist
|
|
145
|
+
- [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
|
|
146
|
+
- [ ] All 7 mandatory sections present with explicit headers.
|
|
147
|
+
- [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
|
|
148
|
+
- [ ] Code exemplars provided with valid syntax fencing.
|
|
149
|
+
- [ ] Zero dummy placeholder strings or unpopulated template markers present.
|
|
150
|
+
- [ ] Project build, test suite, and doctor check pass 100% cleanly.
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: design-system-tokens
|
|
3
|
+
description: Production-grade Design System Tokens playbook for design
|
|
4
|
+
operations, UX systems, and growth strategy.
|
|
5
|
+
metadata:
|
|
6
|
+
author: agents-united
|
|
7
|
+
version: 2.0.0
|
|
8
|
+
icon: 🪙
|
|
9
|
+
disable-slash-command: true
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Design System Tokens
|
|
13
|
+
|
|
14
|
+
## Overview & Purpose
|
|
15
|
+
The Design System Tokens skill provides a deterministic framework for executing design system tokens processes in modern software products.
|
|
16
|
+
|
|
17
|
+
Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
|
|
18
|
+
|
|
19
|
+
## Execution Triggers & Prerequisites
|
|
20
|
+
### Execution Triggers
|
|
21
|
+
- Direct request to execute Design System Tokens tasks.
|
|
22
|
+
- Auditing existing product assets or workflows.
|
|
23
|
+
- Standardizing design-system-tokens procedures across team projects.
|
|
24
|
+
- Preparing design handoffs or growth campaign launches.
|
|
25
|
+
|
|
26
|
+
### Prerequisites
|
|
27
|
+
- Project workspace configured with design system tokens or component libraries.
|
|
28
|
+
- Target UI design specification or growth experiment hypothesis.
|
|
29
|
+
- Testing and linting tools operational.
|
|
30
|
+
- Clean git working directory.
|
|
31
|
+
|
|
32
|
+
## Input & Output Requirements
|
|
33
|
+
### Inputs
|
|
34
|
+
| Parameter | Type | Required | Description |
|
|
35
|
+
|---|---|---|---|
|
|
36
|
+
| `target_scope` | String | Yes | Target UI component, page, or campaign scope |
|
|
37
|
+
| `config` | Object | Optional | Specific parameters and threshold configurations |
|
|
38
|
+
| `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
|
|
39
|
+
| `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
|
|
40
|
+
|
|
41
|
+
### Outputs
|
|
42
|
+
| Artifact | Path / Format | Description |
|
|
43
|
+
|---|---|---|
|
|
44
|
+
| Specification Document | `docs/design-system-tokens/spec.md` | Full specification and guidelines document |
|
|
45
|
+
| Component / Asset Files | `src/design-system-tokens/*` | Implemented design tokens, components, or campaign assets |
|
|
46
|
+
| Audit Report | `reports/design-system-tokens/summary.json` | Health check and audit metric results |
|
|
47
|
+
|
|
48
|
+
## Step-by-Step Execution Runbook
|
|
49
|
+
|
|
50
|
+
### Phase 1: Pre-Execution Discovery & Workspace Analysis
|
|
51
|
+
1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
|
|
52
|
+
```bash
|
|
53
|
+
find src/ docs/ -maxdepth 3 -type f
|
|
54
|
+
```
|
|
55
|
+
2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
|
|
56
|
+
3. Establish baseline quality metrics and target benchmarks.
|
|
57
|
+
4. Verify working tree status to ensure clean git workspace.
|
|
58
|
+
```bash
|
|
59
|
+
git status --short
|
|
60
|
+
```
|
|
61
|
+
5. Formulate initial execution plan.
|
|
62
|
+
|
|
63
|
+
### Phase 2: Input Contract Validation & Strategy Selection
|
|
64
|
+
1. Validate input parameters against technical feasibility and design system guidelines.
|
|
65
|
+
2. Select implementation pattern matching component or campaign architecture.
|
|
66
|
+
3. Establish verification rules and accessibility / conversion thresholds.
|
|
67
|
+
4. Formulate atomic step-by-step execution sequence.
|
|
68
|
+
5. Create temporary working directory if needed.
|
|
69
|
+
|
|
70
|
+
### Phase 3: Core Step-by-Step Implementation Execution
|
|
71
|
+
1. Author primary specification document at `docs/design-system-tokens/spec.md`.
|
|
72
|
+
2. Generate code, token, or layout implementation files.
|
|
73
|
+
```bash
|
|
74
|
+
npm run typecheck
|
|
75
|
+
```
|
|
76
|
+
3. Apply automated formatting and linting tools.
|
|
77
|
+
4. Execute unit or visual regression tests.
|
|
78
|
+
```bash
|
|
79
|
+
npm test
|
|
80
|
+
```
|
|
81
|
+
5. Refactor asset structure for optimal performance and maintainability.
|
|
82
|
+
|
|
83
|
+
### Phase 4: Verification, Testing & Quality Gate Checking
|
|
84
|
+
1. Run full project verification suite.
|
|
85
|
+
```bash
|
|
86
|
+
npm run typecheck && npm test && npm run build
|
|
87
|
+
```
|
|
88
|
+
2. Verify zero lint errors, type warnings, or broken references.
|
|
89
|
+
3. Execute CLI health doctor check.
|
|
90
|
+
```bash
|
|
91
|
+
node dist/cli.js doctor
|
|
92
|
+
```
|
|
93
|
+
4. Assert all acceptance criteria are satisfied.
|
|
94
|
+
|
|
95
|
+
### Phase 5: Post-Execution Cleanup & Artifact Generation
|
|
96
|
+
1. Generate execution summary report at `reports/design-system-tokens/summary.md`.
|
|
97
|
+
2. Clean up temporary build artifacts and scratch files.
|
|
98
|
+
3. Commit generated files to git repository.
|
|
99
|
+
```bash
|
|
100
|
+
git add docs/design-system-tokens/ reports/design-system-tokens/
|
|
101
|
+
git commit -m "feat(design-system-tokens): implement Design System Tokens playbook artifacts"
|
|
102
|
+
```
|
|
103
|
+
4. Publish documentation for team review.
|
|
104
|
+
|
|
105
|
+
## Code & Configuration Exemplars
|
|
106
|
+
|
|
107
|
+
### Exemplar 1: Design System Tokens Configuration Specification
|
|
108
|
+
```yaml
|
|
109
|
+
version: "2.0.0"
|
|
110
|
+
metadata:
|
|
111
|
+
skill: "design-system-tokens"
|
|
112
|
+
author: "agents-united"
|
|
113
|
+
rules:
|
|
114
|
+
strictValidation: true
|
|
115
|
+
reporting:
|
|
116
|
+
format: "json"
|
|
117
|
+
output: "reports/design-system-tokens/summary.json"
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Exemplar 2: Design System Tokens Helper Module
|
|
121
|
+
```typescript
|
|
122
|
+
export function runDesignSystemTokens(scope: string): boolean {
|
|
123
|
+
console.log('Running Design System Tokens on:', scope);
|
|
124
|
+
return true;
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## Edge Cases & Error Recovery Procedures
|
|
129
|
+
|
|
130
|
+
### Scenario A: Validation Failure in Design System Tokens
|
|
131
|
+
1. **Diagnosis**: Specification or code asset fails validation rules in design-system-tokens.
|
|
132
|
+
2. **Recovery Protocol**:
|
|
133
|
+
- Step 1: Inspect error log at reports directory.
|
|
134
|
+
- Step 2: Correct non-compliant syntax or structure.
|
|
135
|
+
- Step 3: Re-run verification pipeline.
|
|
136
|
+
|
|
137
|
+
### Scenario B: Missing Resource for Design System Tokens
|
|
138
|
+
1. **Diagnosis**: Target design token or configuration asset missing from workspace.
|
|
139
|
+
2. **Recovery Protocol**:
|
|
140
|
+
- Step 1: Generate baseline resource file from standard template.
|
|
141
|
+
- Step 2: Update configuration references.
|
|
142
|
+
- Step 3: Resume runbook execution.
|
|
143
|
+
|
|
144
|
+
## Verification & Validation Checklist
|
|
145
|
+
- [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
|
|
146
|
+
- [ ] All 7 mandatory sections present with explicit headers.
|
|
147
|
+
- [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
|
|
148
|
+
- [ ] Code exemplars provided with valid syntax fencing.
|
|
149
|
+
- [ ] Zero dummy placeholder strings or unpopulated template markers present.
|
|
150
|
+
- [ ] Project build, test suite, and doctor check pass 100% cleanly.
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: design-tokens-management
|
|
3
|
+
description: Production-grade Design Tokens Management playbook for design
|
|
4
|
+
operations, UX systems, and growth strategy.
|
|
5
|
+
metadata:
|
|
6
|
+
author: agents-united
|
|
7
|
+
version: 2.0.0
|
|
8
|
+
icon: 🎨
|
|
9
|
+
disable-slash-command: true
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Design Tokens Management
|
|
13
|
+
|
|
14
|
+
## Overview & Purpose
|
|
15
|
+
The Design Tokens Management skill provides a deterministic framework for executing design tokens management processes in modern software products.
|
|
16
|
+
|
|
17
|
+
Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
|
|
18
|
+
|
|
19
|
+
## Execution Triggers & Prerequisites
|
|
20
|
+
### Execution Triggers
|
|
21
|
+
- Direct request to execute Design Tokens Management tasks.
|
|
22
|
+
- Auditing existing product assets or workflows.
|
|
23
|
+
- Standardizing design-tokens-management procedures across team projects.
|
|
24
|
+
- Preparing design handoffs or growth campaign launches.
|
|
25
|
+
|
|
26
|
+
### Prerequisites
|
|
27
|
+
- Project workspace configured with design system tokens or component libraries.
|
|
28
|
+
- Target UI design specification or growth experiment hypothesis.
|
|
29
|
+
- Testing and linting tools operational.
|
|
30
|
+
- Clean git working directory.
|
|
31
|
+
|
|
32
|
+
## Input & Output Requirements
|
|
33
|
+
### Inputs
|
|
34
|
+
| Parameter | Type | Required | Description |
|
|
35
|
+
|---|---|---|---|
|
|
36
|
+
| `target_scope` | String | Yes | Target UI component, page, or campaign scope |
|
|
37
|
+
| `config` | Object | Optional | Specific parameters and threshold configurations |
|
|
38
|
+
| `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
|
|
39
|
+
| `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
|
|
40
|
+
|
|
41
|
+
### Outputs
|
|
42
|
+
| Artifact | Path / Format | Description |
|
|
43
|
+
|---|---|---|
|
|
44
|
+
| Specification Document | `docs/design-tokens-management/spec.md` | Full specification and guidelines document |
|
|
45
|
+
| Component / Asset Files | `src/design-tokens-management/*` | Implemented design tokens, components, or campaign assets |
|
|
46
|
+
| Audit Report | `reports/design-tokens-management/summary.json` | Health check and audit metric results |
|
|
47
|
+
|
|
48
|
+
## Step-by-Step Execution Runbook
|
|
49
|
+
|
|
50
|
+
### Phase 1: Pre-Execution Discovery & Workspace Analysis
|
|
51
|
+
1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
|
|
52
|
+
```bash
|
|
53
|
+
find src/ docs/ -maxdepth 3 -type f
|
|
54
|
+
```
|
|
55
|
+
2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
|
|
56
|
+
3. Establish baseline quality metrics and target benchmarks.
|
|
57
|
+
4. Verify working tree status to ensure clean git workspace.
|
|
58
|
+
```bash
|
|
59
|
+
git status --short
|
|
60
|
+
```
|
|
61
|
+
5. Formulate initial execution plan.
|
|
62
|
+
|
|
63
|
+
### Phase 2: Input Contract Validation & Strategy Selection
|
|
64
|
+
1. Validate input parameters against technical feasibility and design system guidelines.
|
|
65
|
+
2. Select implementation pattern matching component or campaign architecture.
|
|
66
|
+
3. Establish verification rules and accessibility / conversion thresholds.
|
|
67
|
+
4. Formulate atomic step-by-step execution sequence.
|
|
68
|
+
5. Create temporary working directory if needed.
|
|
69
|
+
|
|
70
|
+
### Phase 3: Core Step-by-Step Implementation Execution
|
|
71
|
+
1. Author primary specification document at `docs/design-tokens-management/spec.md`.
|
|
72
|
+
2. Generate code, token, or layout implementation files.
|
|
73
|
+
```bash
|
|
74
|
+
npm run typecheck
|
|
75
|
+
```
|
|
76
|
+
3. Apply automated formatting and linting tools.
|
|
77
|
+
4. Execute unit or visual regression tests.
|
|
78
|
+
```bash
|
|
79
|
+
npm test
|
|
80
|
+
```
|
|
81
|
+
5. Refactor asset structure for optimal performance and maintainability.
|
|
82
|
+
|
|
83
|
+
### Phase 4: Verification, Testing & Quality Gate Checking
|
|
84
|
+
1. Run full project verification suite.
|
|
85
|
+
```bash
|
|
86
|
+
npm run typecheck && npm test && npm run build
|
|
87
|
+
```
|
|
88
|
+
2. Verify zero lint errors, type warnings, or broken references.
|
|
89
|
+
3. Execute CLI health doctor check.
|
|
90
|
+
```bash
|
|
91
|
+
node dist/cli.js doctor
|
|
92
|
+
```
|
|
93
|
+
4. Assert all acceptance criteria are satisfied.
|
|
94
|
+
|
|
95
|
+
### Phase 5: Post-Execution Cleanup & Artifact Generation
|
|
96
|
+
1. Generate execution summary report at `reports/design-tokens-management/summary.md`.
|
|
97
|
+
2. Clean up temporary build artifacts and scratch files.
|
|
98
|
+
3. Commit generated files to git repository.
|
|
99
|
+
```bash
|
|
100
|
+
git add docs/design-tokens-management/ reports/design-tokens-management/
|
|
101
|
+
git commit -m "feat(design-tokens-management): implement Design Tokens Management playbook artifacts"
|
|
102
|
+
```
|
|
103
|
+
4. Publish documentation for team review.
|
|
104
|
+
|
|
105
|
+
## Code & Configuration Exemplars
|
|
106
|
+
|
|
107
|
+
### Exemplar 1: Design Tokens Management Configuration Specification
|
|
108
|
+
```yaml
|
|
109
|
+
version: "2.0.0"
|
|
110
|
+
metadata:
|
|
111
|
+
skill: "design-tokens-management"
|
|
112
|
+
author: "agents-united"
|
|
113
|
+
rules:
|
|
114
|
+
strictValidation: true
|
|
115
|
+
reporting:
|
|
116
|
+
format: "json"
|
|
117
|
+
output: "reports/design-tokens-management/summary.json"
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Exemplar 2: Design Tokens Management Helper Module
|
|
121
|
+
```typescript
|
|
122
|
+
export function runDesignTokensManagement(scope: string): boolean {
|
|
123
|
+
console.log('Running Design Tokens Management on:', scope);
|
|
124
|
+
return true;
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## Edge Cases & Error Recovery Procedures
|
|
129
|
+
|
|
130
|
+
### Scenario A: Validation Failure in Design Tokens Management
|
|
131
|
+
1. **Diagnosis**: Specification or code asset fails validation rules in design-tokens-management.
|
|
132
|
+
2. **Recovery Protocol**:
|
|
133
|
+
- Step 1: Inspect error log at reports directory.
|
|
134
|
+
- Step 2: Correct non-compliant syntax or structure.
|
|
135
|
+
- Step 3: Re-run verification pipeline.
|
|
136
|
+
|
|
137
|
+
### Scenario B: Missing Resource for Design Tokens Management
|
|
138
|
+
1. **Diagnosis**: Target design token or configuration asset missing from workspace.
|
|
139
|
+
2. **Recovery Protocol**:
|
|
140
|
+
- Step 1: Generate baseline resource file from standard template.
|
|
141
|
+
- Step 2: Update configuration references.
|
|
142
|
+
- Step 3: Resume runbook execution.
|
|
143
|
+
|
|
144
|
+
## Verification & Validation Checklist
|
|
145
|
+
- [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
|
|
146
|
+
- [ ] All 7 mandatory sections present with explicit headers.
|
|
147
|
+
- [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
|
|
148
|
+
- [ ] Code exemplars provided with valid syntax fencing.
|
|
149
|
+
- [ ] Zero dummy placeholder strings or unpopulated template markers present.
|
|
150
|
+
- [ ] Project build, test suite, and doctor check pass 100% cleanly.
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: design-version-control
|
|
3
|
+
description: Production-grade Design Version Control playbook for design
|
|
4
|
+
operations, UX systems, and growth strategy.
|
|
5
|
+
metadata:
|
|
6
|
+
author: agents-united
|
|
7
|
+
version: 2.0.0
|
|
8
|
+
icon: 🔀
|
|
9
|
+
disable-slash-command: true
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Design Version Control
|
|
13
|
+
|
|
14
|
+
## Overview & Purpose
|
|
15
|
+
The Design Version Control skill provides a deterministic framework for executing design version control processes in modern software products.
|
|
16
|
+
|
|
17
|
+
Following this skill ensures high usability, visual consistency, rapid iteration, and complete cross-functional team alignment.
|
|
18
|
+
|
|
19
|
+
## Execution Triggers & Prerequisites
|
|
20
|
+
### Execution Triggers
|
|
21
|
+
- Direct request to execute Design Version Control tasks.
|
|
22
|
+
- Auditing existing product assets or workflows.
|
|
23
|
+
- Standardizing design-version-control procedures across team projects.
|
|
24
|
+
- Preparing design handoffs or growth campaign launches.
|
|
25
|
+
|
|
26
|
+
### Prerequisites
|
|
27
|
+
- Project workspace configured with design system tokens or component libraries.
|
|
28
|
+
- Target UI design specification or growth experiment hypothesis.
|
|
29
|
+
- Testing and linting tools operational.
|
|
30
|
+
- Clean git working directory.
|
|
31
|
+
|
|
32
|
+
## Input & Output Requirements
|
|
33
|
+
### Inputs
|
|
34
|
+
| Parameter | Type | Required | Description |
|
|
35
|
+
|---|---|---|---|
|
|
36
|
+
| `target_scope` | String | Yes | Target UI component, page, or campaign scope |
|
|
37
|
+
| `config` | Object | Optional | Specific parameters and threshold configurations |
|
|
38
|
+
| `output_dir` | Directory Path | Optional | Destination directory for generated artifacts |
|
|
39
|
+
| `strict_mode` | Boolean | Optional | Enforce strict zero-warning validation |
|
|
40
|
+
|
|
41
|
+
### Outputs
|
|
42
|
+
| Artifact | Path / Format | Description |
|
|
43
|
+
|---|---|---|
|
|
44
|
+
| Specification Document | `docs/design-version-control/spec.md` | Full specification and guidelines document |
|
|
45
|
+
| Component / Asset Files | `src/design-version-control/*` | Implemented design tokens, components, or campaign assets |
|
|
46
|
+
| Audit Report | `reports/design-version-control/summary.json` | Health check and audit metric results |
|
|
47
|
+
|
|
48
|
+
## Step-by-Step Execution Runbook
|
|
49
|
+
|
|
50
|
+
### Phase 1: Pre-Execution Discovery & Workspace Analysis
|
|
51
|
+
1. Inspect workspace repository to locate relevant UI components, tokens, or campaign assets.
|
|
52
|
+
```bash
|
|
53
|
+
find src/ docs/ -maxdepth 3 -type f
|
|
54
|
+
```
|
|
55
|
+
2. Analyze domain requirements and classify core UI elements, interaction flows, or growth metrics.
|
|
56
|
+
3. Establish baseline quality metrics and target benchmarks.
|
|
57
|
+
4. Verify working tree status to ensure clean git workspace.
|
|
58
|
+
```bash
|
|
59
|
+
git status --short
|
|
60
|
+
```
|
|
61
|
+
5. Formulate initial execution plan.
|
|
62
|
+
|
|
63
|
+
### Phase 2: Input Contract Validation & Strategy Selection
|
|
64
|
+
1. Validate input parameters against technical feasibility and design system guidelines.
|
|
65
|
+
2. Select implementation pattern matching component or campaign architecture.
|
|
66
|
+
3. Establish verification rules and accessibility / conversion thresholds.
|
|
67
|
+
4. Formulate atomic step-by-step execution sequence.
|
|
68
|
+
5. Create temporary working directory if needed.
|
|
69
|
+
|
|
70
|
+
### Phase 3: Core Step-by-Step Implementation Execution
|
|
71
|
+
1. Author primary specification document at `docs/design-version-control/spec.md`.
|
|
72
|
+
2. Generate code, token, or layout implementation files.
|
|
73
|
+
```bash
|
|
74
|
+
npm run typecheck
|
|
75
|
+
```
|
|
76
|
+
3. Apply automated formatting and linting tools.
|
|
77
|
+
4. Execute unit or visual regression tests.
|
|
78
|
+
```bash
|
|
79
|
+
npm test
|
|
80
|
+
```
|
|
81
|
+
5. Refactor asset structure for optimal performance and maintainability.
|
|
82
|
+
|
|
83
|
+
### Phase 4: Verification, Testing & Quality Gate Checking
|
|
84
|
+
1. Run full project verification suite.
|
|
85
|
+
```bash
|
|
86
|
+
npm run typecheck && npm test && npm run build
|
|
87
|
+
```
|
|
88
|
+
2. Verify zero lint errors, type warnings, or broken references.
|
|
89
|
+
3. Execute CLI health doctor check.
|
|
90
|
+
```bash
|
|
91
|
+
node dist/cli.js doctor
|
|
92
|
+
```
|
|
93
|
+
4. Assert all acceptance criteria are satisfied.
|
|
94
|
+
|
|
95
|
+
### Phase 5: Post-Execution Cleanup & Artifact Generation
|
|
96
|
+
1. Generate execution summary report at `reports/design-version-control/summary.md`.
|
|
97
|
+
2. Clean up temporary build artifacts and scratch files.
|
|
98
|
+
3. Commit generated files to git repository.
|
|
99
|
+
```bash
|
|
100
|
+
git add docs/design-version-control/ reports/design-version-control/
|
|
101
|
+
git commit -m "feat(design-version-control): implement Design Version Control playbook artifacts"
|
|
102
|
+
```
|
|
103
|
+
4. Publish documentation for team review.
|
|
104
|
+
|
|
105
|
+
## Code & Configuration Exemplars
|
|
106
|
+
|
|
107
|
+
### Exemplar 1: Design Version Control Configuration Specification
|
|
108
|
+
```yaml
|
|
109
|
+
version: "2.0.0"
|
|
110
|
+
metadata:
|
|
111
|
+
skill: "design-version-control"
|
|
112
|
+
author: "agents-united"
|
|
113
|
+
rules:
|
|
114
|
+
strictValidation: true
|
|
115
|
+
reporting:
|
|
116
|
+
format: "json"
|
|
117
|
+
output: "reports/design-version-control/summary.json"
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Exemplar 2: Design Version Control Helper Module
|
|
121
|
+
```typescript
|
|
122
|
+
export function runDesignVersionControl(scope: string): boolean {
|
|
123
|
+
console.log('Running Design Version Control on:', scope);
|
|
124
|
+
return true;
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## Edge Cases & Error Recovery Procedures
|
|
129
|
+
|
|
130
|
+
### Scenario A: Validation Failure in Design Version Control
|
|
131
|
+
1. **Diagnosis**: Specification or code asset fails validation rules in design-version-control.
|
|
132
|
+
2. **Recovery Protocol**:
|
|
133
|
+
- Step 1: Inspect error log at reports directory.
|
|
134
|
+
- Step 2: Correct non-compliant syntax or structure.
|
|
135
|
+
- Step 3: Re-run verification pipeline.
|
|
136
|
+
|
|
137
|
+
### Scenario B: Missing Resource for Design Version Control
|
|
138
|
+
1. **Diagnosis**: Target design token or configuration asset missing from workspace.
|
|
139
|
+
2. **Recovery Protocol**:
|
|
140
|
+
- Step 1: Generate baseline resource file from standard template.
|
|
141
|
+
- Step 2: Update configuration references.
|
|
142
|
+
- Step 3: Resume runbook execution.
|
|
143
|
+
|
|
144
|
+
## Verification & Validation Checklist
|
|
145
|
+
- [ ] Frontmatter conforms strictly to `author: "agents-united"` and `version: "2.0.0"`.
|
|
146
|
+
- [ ] All 7 mandatory sections present with explicit headers.
|
|
147
|
+
- [ ] Step-by-Step Execution Runbook body contains >= 50 lines.
|
|
148
|
+
- [ ] Code exemplars provided with valid syntax fencing.
|
|
149
|
+
- [ ] Zero dummy placeholder strings or unpopulated template markers present.
|
|
150
|
+
- [ ] Project build, test suite, and doctor check pass 100% cleanly.
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: diagnosing-bugs
|
|
3
|
+
description: Evidence-based bug diagnosis and root-cause analysis workflow to
|
|
4
|
+
isolate defect origins without blind guesswork.
|
|
5
|
+
metadata:
|
|
6
|
+
author: Matt Pocock (mattpocock/skills)
|
|
7
|
+
version: 1.0.0
|
|
8
|
+
source: https://github.com/mattpocock/skills
|
|
9
|
+
icon: 🔍
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Evidence-Driven Bug Diagnosis
|
|
13
|
+
|
|
14
|
+
## Overview & Purpose
|
|
15
|
+
`diagnosing-bugs` provides a step-by-step diagnostic workflow for isolating runtime failures, unexpected behaviors, and regressions by gathering empirical evidence before attempting fixes.
|
|
16
|
+
|
|
17
|
+
## Input & Output Requirements
|
|
18
|
+
### Inputs
|
|
19
|
+
| Parameter | Type | Required | Description |
|
|
20
|
+
|---|---|---|---|
|
|
21
|
+
| `error_log` | String / Path | Yes | Error log, stack trace, or bug report snippet |
|
|
22
|
+
|
|
23
|
+
### Outputs
|
|
24
|
+
| Artifact | Path / Format | Description |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| Diagnosis Report | Inline / Log | Isolated root cause evidence and targeted fix plan |
|
|
27
|
+
|
|
28
|
+
## Step-by-Step Execution Runbook
|
|
29
|
+
|
|
30
|
+
### Phase 1 — Evidence Gathering
|
|
31
|
+
1. Extract exact error messages, stack traces, line numbers, and runtime environments.
|
|
32
|
+
2. Read the full un-truncated source code around the reported crash site.
|
|
33
|
+
|
|
34
|
+
### Phase 2 — Reproduction & Hypothesis Testing
|
|
35
|
+
1. Create a minimal automated reproduction test case.
|
|
36
|
+
2. Formulate 2–3 candidate hypotheses and test them systematically.
|
|
37
|
+
3. Confirm exact conditions required to trigger the bug.
|
|
38
|
+
|
|
39
|
+
### Phase 3 — Root Cause Summary
|
|
40
|
+
1. Document the exact mechanism causing the failure.
|
|
41
|
+
2. Hand off verified root cause to implementation/fix workflow.
|
|
42
|
+
|
|
43
|
+
## Verification & Validation Checklist
|
|
44
|
+
- [ ] Frontmatter contains author attribution to Matt Pocock.
|
|
45
|
+
- [ ] Diagnosis is backed by empirical stack trace or log evidence.
|