feat(marketplace): command consolidation + 8 new plugins (v8.1.0 → v9.0.0) [BREAKING]
Phase 1b: Rename all ~94 commands across 12 plugins to /<noun> <action> sub-command pattern. Git-flow consolidated from 8→5 commands (commit variants absorbed into --push/--merge/--sync flags). Dispatch files, name: frontmatter, and cross-reference updates for all plugins. Phase 2: Design documents for 8 new plugins in docs/designs/. Phase 3: Scaffold 8 new plugins — saas-api-platform, saas-db-migrate, saas-react-platform, saas-test-pilot, data-seed, ops-release-manager, ops-deploy-pipeline, debug-mcp. Each with plugin.json, commands, agents, skills, README, and claude-md-integration. Marketplace grows from 12→20. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -24,8 +24,8 @@ You are a strict design system compliance auditor. Your role is to review code f
|
||||
## Trigger Conditions
|
||||
|
||||
Activate this agent when:
|
||||
- User runs `/design-review <path>`
|
||||
- User runs `/design-gate <path>`
|
||||
- User runs `/viz design-review <path>`
|
||||
- User runs `/viz design-gate <path>`
|
||||
- Projman orchestrator requests design domain gate check
|
||||
- Code review includes DMC/Dash components
|
||||
|
||||
@@ -48,7 +48,7 @@ Activate this agent when:
|
||||
|
||||
### Review Mode (default)
|
||||
|
||||
Triggered by `/design-review <path>`
|
||||
Triggered by `/viz design-review <path>`
|
||||
|
||||
**Characteristics:**
|
||||
- Produces detailed report with all findings
|
||||
@@ -59,7 +59,7 @@ Triggered by `/design-review <path>`
|
||||
|
||||
### Gate Mode
|
||||
|
||||
Triggered by `/design-gate <path>` or projman orchestrator domain gate
|
||||
Triggered by `/viz design-gate <path>` or projman orchestrator domain gate
|
||||
|
||||
**Characteristics:**
|
||||
- Binary PASS/FAIL output
|
||||
@@ -136,7 +136,7 @@ Blocking Issues (2):
|
||||
2. app/components/nav.py:12 - Component 'dmc.Navbar' not found
|
||||
Fix: Use 'dmc.AppShell.Navbar' (DMC v0.14+)
|
||||
|
||||
Run /design-review for full audit report.
|
||||
Run /viz design-review for full audit report.
|
||||
```
|
||||
|
||||
### Review Mode Output
|
||||
@@ -270,7 +270,7 @@ When called as a domain gate by projman orchestrator:
|
||||
|
||||
## Example Interactions
|
||||
|
||||
**User**: `/design-review src/pages/`
|
||||
**User**: `/viz design-review src/pages/`
|
||||
**Agent**:
|
||||
1. Scans all .py files in src/pages/
|
||||
2. Identifies DMC component usage
|
||||
@@ -279,7 +279,7 @@ When called as a domain gate by projman orchestrator:
|
||||
5. Runs accessibility validation
|
||||
6. Returns full review report
|
||||
|
||||
**User**: `/design-gate src/`
|
||||
**User**: `/viz design-gate src/`
|
||||
**Agent**:
|
||||
1. Scans all .py files
|
||||
2. Identifies FAIL-level issues only
|
||||
|
||||
@@ -10,12 +10,12 @@ Add this snippet to your project's CLAUDE.md to enable viz-platform capabilities
|
||||
This project uses viz-platform for Dash Mantine Components dashboards.
|
||||
|
||||
### Available Commands
|
||||
- `/viz-component {name}` - Inspect DMC component props
|
||||
- `/viz-chart {type}` - Create Plotly charts (line, bar, scatter, pie, area, histogram, box, heatmap, sunburst, treemap)
|
||||
- `/viz-dashboard {template}` - Create layouts (basic, sidebar, tabs, split)
|
||||
- `/viz-theme {name}` - Apply a theme
|
||||
- `/viz-theme-new {name}` - Create custom theme
|
||||
- `/viz-theme-css {name}` - Export theme as CSS
|
||||
- `/viz component {name}` - Inspect DMC component props
|
||||
- `/viz chart {type}` - Create Plotly charts (line, bar, scatter, pie, area, histogram, box, heatmap, sunburst, treemap)
|
||||
- `/viz dashboard {template}` - Create layouts (basic, sidebar, tabs, split)
|
||||
- `/viz theme {name}` - Apply a theme
|
||||
- `/viz theme-new {name}` - Create custom theme
|
||||
- `/viz theme-css {name}` - Export theme as CSS
|
||||
|
||||
### MCP Tools Available
|
||||
- **DMC**: list_components, get_component_props, validate_component
|
||||
@@ -44,13 +44,13 @@ If using with data-platform, add this section:
|
||||
## Data + Visualization Workflow
|
||||
|
||||
### Data Loading (data-platform)
|
||||
- `/data-ingest {file}` - Load CSV, Parquet, or JSON
|
||||
- `/data-schema {table}` - View database schema
|
||||
- `/data-profile {data_ref}` - Statistical summary
|
||||
- `/data ingest {file}` - Load CSV, Parquet, or JSON
|
||||
- `/data schema {table}` - View database schema
|
||||
- `/data profile {data_ref}` - Statistical summary
|
||||
|
||||
### Visualization (viz-platform)
|
||||
- `/viz-chart {type}` - Create charts from loaded data
|
||||
- `/viz-dashboard {template}` - Build dashboard layouts
|
||||
- `/viz chart {type}` - Create charts from loaded data
|
||||
- `/viz dashboard {template}` - Build dashboard layouts
|
||||
|
||||
### Workflow Pattern
|
||||
1. Load data: `read_csv("data.csv")` → returns `data_ref`
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: viz accessibility-check
|
||||
description: Validate color accessibility for color blind users
|
||||
---
|
||||
|
||||
# Accessibility Check
|
||||
# /viz accessibility-check
|
||||
|
||||
## Skills to Load
|
||||
- skills/mcp-tools-reference.md
|
||||
@@ -21,7 +22,7 @@ Validate theme or chart colors for color blind accessibility.
|
||||
## Usage
|
||||
|
||||
```
|
||||
/accessibility-check {target}
|
||||
/viz accessibility-check {target}
|
||||
```
|
||||
|
||||
## Arguments
|
||||
@@ -41,5 +42,5 @@ accessibility_validate_theme(theme_name="corporate")
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/viz-theme-new {name}` - Create accessible theme
|
||||
- `/viz-chart {type}` - Create chart (check colors after)
|
||||
- `/viz theme-new {name}` - Create accessible theme
|
||||
- `/viz chart {type}` - Create chart (check colors after)
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: viz breakpoints
|
||||
description: Configure responsive breakpoints for dashboard layouts
|
||||
---
|
||||
|
||||
# Viz Breakpoints
|
||||
# /viz breakpoints
|
||||
|
||||
## Skills to Load
|
||||
- skills/mcp-tools-reference.md
|
||||
@@ -21,7 +22,7 @@ Configure responsive breakpoints for mobile-first design across screen sizes.
|
||||
## Usage
|
||||
|
||||
```
|
||||
/viz-breakpoints {layout_ref}
|
||||
/viz breakpoints {layout_ref}
|
||||
```
|
||||
|
||||
## Arguments
|
||||
@@ -30,7 +31,7 @@ Configure responsive breakpoints for mobile-first design across screen sizes.
|
||||
|
||||
## Workflow
|
||||
|
||||
1. **User invokes**: `/viz-breakpoints my-dashboard`
|
||||
1. **User invokes**: `/viz breakpoints my-dashboard`
|
||||
2. **Agent asks**: Which breakpoints to customize? (shows current settings)
|
||||
3. **Agent asks**: Mobile column count? (xs, typically 1-2)
|
||||
4. **Agent asks**: Tablet column count? (md, typically 4-6)
|
||||
@@ -39,5 +40,5 @@ Configure responsive breakpoints for mobile-first design across screen sizes.
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/viz-dashboard {template}` - Create layout with default breakpoints
|
||||
- `/viz-theme {name}` - Theme includes default spacing values
|
||||
- `/viz dashboard {template}` - Create layout with default breakpoints
|
||||
- `/viz theme {name}` - Theme includes default spacing values
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: viz chart-export
|
||||
description: Export a Plotly chart to PNG, SVG, or PDF format
|
||||
---
|
||||
|
||||
# Viz Chart Export
|
||||
# /viz chart-export
|
||||
|
||||
## Skills to Load
|
||||
- skills/mcp-tools-reference.md
|
||||
@@ -21,7 +22,7 @@ Export a Plotly chart to static image formats.
|
||||
## Usage
|
||||
|
||||
```
|
||||
/viz-chart-export {format}
|
||||
/viz chart-export {format}
|
||||
```
|
||||
|
||||
## Arguments
|
||||
@@ -38,5 +39,5 @@ Requires `kaleido` package: `pip install kaleido`
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/viz-chart {type}` - Create a chart
|
||||
- `/viz-theme {name}` - Apply theme before export
|
||||
- `/viz chart {type}` - Create a chart
|
||||
- `/viz theme {name}` - Apply theme before export
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: viz chart
|
||||
description: Create a Plotly chart with theme integration
|
||||
---
|
||||
|
||||
# Viz Chart
|
||||
# /viz chart
|
||||
|
||||
## Skills to Load
|
||||
- skills/mcp-tools-reference.md
|
||||
@@ -21,7 +22,7 @@ Create a Plotly chart with automatic theme token application.
|
||||
## Usage
|
||||
|
||||
```
|
||||
/viz-chart {type}
|
||||
/viz chart {type}
|
||||
```
|
||||
|
||||
## Arguments
|
||||
@@ -36,6 +37,6 @@ chart_create(chart_type="line", data_ref="df", x="date", y="value", theme=None)
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/viz-chart-export {format}` - Export chart to image
|
||||
- `/viz-theme {name}` - Apply theme to charts
|
||||
- `/viz-dashboard` - Create layout with charts
|
||||
- `/viz chart-export {format}` - Export chart to image
|
||||
- `/viz theme {name}` - Apply theme to charts
|
||||
- `/viz dashboard` - Create layout with charts
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: viz component
|
||||
description: Inspect Dash Mantine Component props and validation
|
||||
---
|
||||
|
||||
# Viz Component
|
||||
# /viz component
|
||||
|
||||
## Skills to Load
|
||||
- skills/mcp-tools-reference.md
|
||||
@@ -21,7 +22,7 @@ Inspect a DMC component's props, types, and defaults.
|
||||
## Usage
|
||||
|
||||
```
|
||||
/viz-component {name}
|
||||
/viz component {name}
|
||||
```
|
||||
|
||||
## Arguments
|
||||
@@ -38,5 +39,5 @@ validate_component(component="Button", props={"variant": "filled"})
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/viz-chart {type}` - Create charts
|
||||
- `/viz-dashboard {template}` - Create layouts
|
||||
- `/viz chart {type}` - Create charts
|
||||
- `/viz dashboard {template}` - Create layouts
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: viz dashboard
|
||||
description: Create a dashboard layout with the layout-builder agent
|
||||
---
|
||||
|
||||
# Viz Dashboard
|
||||
# /viz dashboard
|
||||
|
||||
## Skills to Load
|
||||
- skills/mcp-tools-reference.md
|
||||
@@ -21,7 +22,7 @@ Create a dashboard layout with filters, grids, and sections.
|
||||
## Usage
|
||||
|
||||
```
|
||||
/viz-dashboard {template}
|
||||
/viz dashboard {template}
|
||||
```
|
||||
|
||||
## Arguments
|
||||
@@ -37,5 +38,5 @@ Activates **layout-builder** agent which orchestrates:
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/viz-breakpoints {layout}` - Configure responsive breakpoints
|
||||
- `/viz-chart {type}` - Add charts to layout
|
||||
- `/viz breakpoints {layout}` - Configure responsive breakpoints
|
||||
- `/viz chart {type}` - Add charts to layout
|
||||
|
||||
@@ -1,4 +1,5 @@
|
||||
---
|
||||
name: viz design-gate
|
||||
description: Design system compliance gate (pass/fail) for sprint execution
|
||||
gate_contract: v1
|
||||
arguments:
|
||||
@@ -7,20 +8,20 @@ arguments:
|
||||
required: true
|
||||
---
|
||||
|
||||
# /design-gate
|
||||
# /viz design-gate
|
||||
|
||||
Binary pass/fail validation for design system compliance. Used by projman orchestrator during sprint execution to gate issue completion.
|
||||
|
||||
## Usage
|
||||
|
||||
```
|
||||
/design-gate <path>
|
||||
/viz design-gate <path>
|
||||
```
|
||||
|
||||
**Examples:**
|
||||
```
|
||||
/design-gate ./app/pages/dashboard.py
|
||||
/design-gate ./app/components/
|
||||
/viz design-gate ./app/pages/dashboard.py
|
||||
/viz design-gate ./app/components/
|
||||
```
|
||||
|
||||
## What It Does
|
||||
@@ -56,7 +57,7 @@ Blocking Issues (2):
|
||||
2. app/components/nav.py:12 - Component 'dmc.Navbar' not found
|
||||
Fix: Use 'dmc.AppShell.Navbar' (DMC v0.14+)
|
||||
|
||||
Run /design-review for full audit report.
|
||||
Run /viz design-review for full audit report.
|
||||
```
|
||||
|
||||
## Integration with projman
|
||||
@@ -68,13 +69,13 @@ This command is automatically invoked by the projman orchestrator when:
|
||||
3. The orchestrator passes the path of changed files
|
||||
|
||||
**Gate behavior:**
|
||||
- PASS → Issue can be marked complete
|
||||
- FAIL → Issue stays open, blocker comment added
|
||||
- PASS -> Issue can be marked complete
|
||||
- FAIL -> Issue stays open, blocker comment added
|
||||
|
||||
## Differences from /design-review
|
||||
## Differences from /viz design-review
|
||||
|
||||
| Aspect | /design-gate | /design-review |
|
||||
|--------|--------------|----------------|
|
||||
| Aspect | /viz design-gate | /viz design-review |
|
||||
|--------|------------------|---------------------|
|
||||
| Output | Binary PASS/FAIL | Detailed report |
|
||||
| Severity | FAIL only | FAIL + WARN + INFO |
|
||||
| Purpose | Automation gate | Human review |
|
||||
@@ -86,7 +87,7 @@ This command is automatically invoked by the projman orchestrator when:
|
||||
- **Sprint execution**: Automatic quality gates
|
||||
- **Quick validation**: Fast pass/fail without full report
|
||||
|
||||
For detailed findings, use `/design-review` instead.
|
||||
For detailed findings, use `/viz design-review` instead.
|
||||
|
||||
## Requirements
|
||||
|
||||
@@ -1,4 +1,5 @@
|
||||
---
|
||||
name: viz design-review
|
||||
description: Audit codebase for design system compliance
|
||||
arguments:
|
||||
- name: path
|
||||
@@ -6,21 +7,21 @@ arguments:
|
||||
required: true
|
||||
---
|
||||
|
||||
# /design-review
|
||||
# /viz design-review
|
||||
|
||||
Scans target path for Dash Mantine Components usage and validates against design system standards.
|
||||
|
||||
## Usage
|
||||
|
||||
```
|
||||
/design-review <path>
|
||||
/viz design-review <path>
|
||||
```
|
||||
|
||||
**Examples:**
|
||||
```
|
||||
/design-review ./app/pages/
|
||||
/design-review ./app/components/dashboard.py
|
||||
/design-review .
|
||||
/viz design-review ./app/pages/
|
||||
/viz design-review ./app/components/dashboard.py
|
||||
/viz design-review .
|
||||
```
|
||||
|
||||
## What It Does
|
||||
@@ -60,9 +61,9 @@ Each finding includes:
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/design-gate` - Binary pass/fail for sprint execution (no detailed report)
|
||||
- `/viz-component` - Inspect individual DMC component props
|
||||
- `/viz-theme` - Check active theme configuration
|
||||
- `/viz design-gate` - Binary pass/fail for sprint execution (no detailed report)
|
||||
- `/viz component` - Inspect individual DMC component props
|
||||
- `/viz theme` - Check active theme configuration
|
||||
|
||||
## Requirements
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: viz setup
|
||||
description: Interactive setup wizard for viz-platform plugin
|
||||
---
|
||||
|
||||
# Viz Setup
|
||||
# /viz setup
|
||||
|
||||
## Visual Output
|
||||
|
||||
@@ -41,5 +42,5 @@ Verify MCP server loads, display summary, prompt session restart.
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/viz-component {name}` - Inspect component props
|
||||
- `/viz-chart {type}` - Create a chart
|
||||
- `/viz component {name}` - Inspect component props
|
||||
- `/viz chart {type}` - Create a chart
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: viz theme-css
|
||||
description: Export a theme as CSS custom properties
|
||||
---
|
||||
|
||||
# Viz Theme CSS
|
||||
# /viz theme-css
|
||||
|
||||
## Skills to Load
|
||||
- skills/mcp-tools-reference.md
|
||||
@@ -21,7 +22,7 @@ Export a theme's design tokens as CSS custom properties.
|
||||
## Usage
|
||||
|
||||
```
|
||||
/viz-theme-css {name}
|
||||
/viz theme-css {name}
|
||||
```
|
||||
|
||||
## Arguments
|
||||
@@ -38,5 +39,5 @@ Use cases: external CSS, design handoff, documentation, other frameworks.
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/viz-theme {name}` - Apply a theme
|
||||
- `/viz-theme-new {name}` - Create a new theme
|
||||
- `/viz theme {name}` - Apply a theme
|
||||
- `/viz theme-new {name}` - Create a new theme
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: viz theme-new
|
||||
description: Create a new custom theme with design tokens
|
||||
---
|
||||
|
||||
# Viz Theme New
|
||||
# /viz theme-new
|
||||
|
||||
## Skills to Load
|
||||
- skills/mcp-tools-reference.md
|
||||
@@ -21,7 +22,7 @@ Create a new custom theme with specified design tokens.
|
||||
## Usage
|
||||
|
||||
```
|
||||
/viz-theme-new {name}
|
||||
/viz theme-new {name}
|
||||
```
|
||||
|
||||
## Arguments
|
||||
@@ -37,5 +38,5 @@ theme_validate(theme_name="corporate")
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/viz-theme {name}` - Apply a theme
|
||||
- `/viz-theme-css {name}` - Export theme as CSS
|
||||
- `/viz theme {name}` - Apply a theme
|
||||
- `/viz theme-css {name}` - Export theme as CSS
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: viz theme
|
||||
description: Apply an existing theme to the current context
|
||||
---
|
||||
|
||||
# Viz Theme
|
||||
# /viz theme
|
||||
|
||||
## Skills to Load
|
||||
- skills/mcp-tools-reference.md
|
||||
@@ -21,7 +22,7 @@ Apply an existing theme to activate its design tokens.
|
||||
## Usage
|
||||
|
||||
```
|
||||
/viz-theme {name}
|
||||
/viz theme {name}
|
||||
```
|
||||
|
||||
## Arguments
|
||||
@@ -41,5 +42,5 @@ When activated, new charts/layouts automatically use theme tokens.
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/viz-theme-new {name}` - Create a new theme
|
||||
- `/viz-theme-css {name}` - Export theme as CSS
|
||||
- `/viz theme-new {name}` - Create a new theme
|
||||
- `/viz theme-css {name}` - Export theme as CSS
|
||||
|
||||
24
plugins/viz-platform/commands/viz.md
Normal file
24
plugins/viz-platform/commands/viz.md
Normal file
@@ -0,0 +1,24 @@
|
||||
---
|
||||
description: Visualization tools with DMC validation, charts, and theming
|
||||
---
|
||||
|
||||
# /viz
|
||||
|
||||
Visualization tools with Dash Mantine Components validation, Plotly charts, and theming.
|
||||
|
||||
## Sub-commands
|
||||
|
||||
| Sub-command | Description |
|
||||
|-------------|-------------|
|
||||
| `/viz theme` | Apply existing theme to visualizations |
|
||||
| `/viz theme-new` | Create new custom theme with design tokens |
|
||||
| `/viz theme-css` | Export theme as CSS custom properties |
|
||||
| `/viz component` | Inspect DMC component props and validation |
|
||||
| `/viz dashboard` | Create dashboard layouts with filters and grids |
|
||||
| `/viz chart` | Create Plotly charts with theme integration |
|
||||
| `/viz chart-export` | Export charts to PNG, SVG, PDF via kaleido |
|
||||
| `/viz breakpoints` | Configure responsive layout breakpoints |
|
||||
| `/viz accessibility-check` | Color blind validation (WCAG contrast ratios) |
|
||||
| `/viz design-review` | Detailed design system audits |
|
||||
| `/viz design-gate` | Binary pass/fail design system validation |
|
||||
| `/viz setup` | Setup wizard for viz-platform MCP server |
|
||||
Reference in New Issue
Block a user