Template

Files

lmiranda 72b3436a24 feat(contract-validator): add gate contract versioning

- design-gate.md and data-gate.md declare gate_contract: v1
- domain-consultation.md Gate Command Reference includes Contract column
- validate_workflow_integration now checks contract version compatibility
- Tests added for match, mismatch, and missing contract scenarios

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-02-02 13:54:19 -05:00

2.3 KiB

Raw Permalink Blame History

description, gate_contract, arguments

description

gate_contract

arguments

Design system compliance gate (pass/fail) for sprint execution

name	description	required
path	File or directory to validate	true

/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>

Examples:

/design-gate ./app/pages/dashboard.py
/design-gate ./app/components/

What It Does

Activates the design-reviewer agent in gate mode
Loads the skills/design-system-audit.md skill
Scans target path for DMC usage
Checks only for FAIL-level violations:
- Invalid component props
- Non-existent components
- Missing required props
- Deprecated components
Returns binary result:
- PASS - No blocking violations found
- FAIL - One or more blocking violations

Output

On PASS

DESIGN GATE: PASS
No blocking design system violations found.

On FAIL

DESIGN GATE: FAIL

Blocking Issues (2):
1. app/pages/home.py:45 - Invalid prop 'onclick' on dmc.Button
   Fix: Use 'n_clicks' for click handling

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.

Integration with projman

This command is automatically invoked by the projman orchestrator when:

An issue has the Domain/Viz label
The orchestrator is about to mark the issue as complete
The orchestrator passes the path of changed files

Gate behavior:

PASS → Issue can be marked complete
FAIL → Issue stays open, blocker comment added

Differences from /design-review

Aspect	/design-gate	/design-review
Output	Binary PASS/FAIL	Detailed report
Severity	FAIL only	FAIL + WARN + INFO
Purpose	Automation gate	Human review
Verbosity	Minimal	Comprehensive

When to Use

Automated pipelines: CI/CD design system checks
Sprint execution: Automatic quality gates
Quick validation: Fast pass/fail without full report

For detailed findings, use /design-review instead.

Requirements

viz-platform MCP server must be running
Target path must exist

2.3 KiB Raw Permalink Blame History