feat: Domain Advisory Pattern - viz-platform integration (Sprint 9) #370

Merged
lmiranda merged 14 commits from feat/sprint-9-domain-advisory-pattern into development 2026-02-01 23:46:54 +00:00
Owner

Summary

Implements the Domain Advisory Pattern for cross-plugin integration between projman and viz-platform. This enables automatic domain detection during sprint planning and execution gates for design system compliance.

Changes

projman

  • New skill: skills/domain-consultation.md - Core integration skill with detection rules, planning protocol, and execution gate protocol
  • Modified: agents/planner.md - Loads domain-consultation skill, adds Domain-Aware Recommendations section
  • Modified: agents/orchestrator.md - Loads domain-consultation skill, adds Domain Gate Checks section
  • Modified: skills/label-taxonomy/labels-reference.md - Adds Domain/Viz and Domain/Data labels

viz-platform

  • New skill: skills/design-system-audit.md - Audit rules for design system compliance
  • New agent: agents/design-reviewer.md - Reviews code for design system compliance
  • New command: commands/design-review.md - Standalone audit command (/design-review <path>)
  • New command: commands/design-gate.md - Binary pass/fail gate command (/design-gate <path>)

Documentation

  • Updated CHANGELOG.md with v5.6.0 entry
  • Updated README.md with Domain Advisory Pattern section
  • Bumped marketplace version to 5.6.0

Architecture

projman (orchestrator)
    │
    ├── Detects Domain/Viz label
    │
    └── Invokes /design-gate
            │
            └── viz-platform (design-reviewer agent)
                    │
                    └── Returns PASS/FAIL

Test Plan

  • Verify /design-review command works on DMC codebase
  • Verify /design-gate returns PASS/FAIL
  • Verify planner detects domain signals in issue descriptions
  • Verify orchestrator invokes gate on Domain/Viz labeled issues
  • Run /labels-sync to create new labels in Gitea

Issues Closed

Closes #356, #357, #358, #359, #360, #361, #362, #363


Generated with Claude Code

## Summary Implements the Domain Advisory Pattern for cross-plugin integration between projman and viz-platform. This enables automatic domain detection during sprint planning and execution gates for design system compliance. ## Changes ### projman - **New skill**: `skills/domain-consultation.md` - Core integration skill with detection rules, planning protocol, and execution gate protocol - **Modified**: `agents/planner.md` - Loads domain-consultation skill, adds Domain-Aware Recommendations section - **Modified**: `agents/orchestrator.md` - Loads domain-consultation skill, adds Domain Gate Checks section - **Modified**: `skills/label-taxonomy/labels-reference.md` - Adds `Domain/Viz` and `Domain/Data` labels ### viz-platform - **New skill**: `skills/design-system-audit.md` - Audit rules for design system compliance - **New agent**: `agents/design-reviewer.md` - Reviews code for design system compliance - **New command**: `commands/design-review.md` - Standalone audit command (`/design-review <path>`) - **New command**: `commands/design-gate.md` - Binary pass/fail gate command (`/design-gate <path>`) ### Documentation - Updated `CHANGELOG.md` with v5.6.0 entry - Updated `README.md` with Domain Advisory Pattern section - Bumped marketplace version to 5.6.0 ## Architecture ``` projman (orchestrator) │ ├── Detects Domain/Viz label │ └── Invokes /design-gate │ └── viz-platform (design-reviewer agent) │ └── Returns PASS/FAIL ``` ## Test Plan - [ ] Verify `/design-review` command works on DMC codebase - [ ] Verify `/design-gate` returns PASS/FAIL - [ ] Verify planner detects domain signals in issue descriptions - [ ] Verify orchestrator invokes gate on Domain/Viz labeled issues - [ ] Run `/labels-sync` to create new labels in Gitea ## Issues Closed Closes #356, #357, #358, #359, #360, #361, #362, #363 --- Generated with [Claude Code](https://claude.ai/code)
lmiranda added 14 commits 2026-02-01 23:33:41 +00:00
Add the core skill that enables projman agents to detect and consult
domain-specific plugins (viz-platform, data-platform) during sprint
lifecycle. Includes domain detection rules, planning protocol,
execution gate protocol, review protocol, and extensibility guidelines.

Closes #356

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add comprehensive design system audit skill that provides:
- What to check: component prop validity, theme token usage,
  accessibility compliance, responsive design
- Common violation patterns at FAIL/WARN/INFO severity levels
- Scanning strategy for finding DMC components in Python files
- Report template for audit output
- MCP tool integration patterns

Closes #357

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add design reviewer agent that uses viz-platform MCP tools to audit code
for design system compliance in Dash/DMC applications.

Features:
- Review mode: detailed report with FAIL/WARN/INFO severity levels
- Gate mode: binary PASS/FAIL for CI/CD integration
- Component validation using validate_component, get_component_props
- Theme compliance checking for hardcoded colors/sizes
- Accessibility validation using accessibility_validate_colors
- Structured output for projman orchestrator integration

Closes #358

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Integrate domain-consultation skill into the planner agent workflow:
- Add skills/domain-consultation.md to Skills to Load section
- Add new responsibility "7. Domain Consultation" between Task Sizing and Issue Creation
- Renumber subsequent sections (Issue Creation -> 8, Request Approval -> 9)
- Add critical reminder #8 to always check domain signals

The domain consultation step analyzes planned issues for domain-specific
signals (viz-platform, data-platform) and appends appropriate acceptance
criteria before issue creation.

Closes #361

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add /design-gate command that provides binary pass/fail validation for
design system compliance. This command is used by projman orchestrator
during sprint execution to gate issue completion for Domain/Viz issues.

Features:
- Binary PASS/FAIL output for automation
- Checks only FAIL-level violations (invalid props, missing components)
- Integrates with projman sprint execution workflow
- Lightweight alternative to /design-review

Closes #360

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add standalone command that invokes the design-reviewer agent to
perform detailed design system compliance audits on target paths.
Returns comprehensive findings grouped by severity with file paths,
line numbers, and recommended fixes.

Closes #359

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add new Domain category with 2 labels for domain-specific validation gates:
- Domain/Viz: triggers viz-platform design gates for frontend/visualization work
- Domain/Data: triggers data-platform data gates for data engineering work

Update version to 5.6.0 and document Domain Advisory Pattern feature.

Closes #363

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Create domain-consultation.md skill with detection rules and gate protocols
- Update orchestrator.md to load skill and run domain gates before completion
- Add critical reminder for domain gate enforcement

Closes #356
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
lmiranda merged commit 192f808f48 into development 2026-02-01 23:46:54 +00:00
lmiranda deleted branch feat/sprint-9-domain-advisory-pattern 2026-02-01 23:46:54 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: personal-projects/leo-claude-mktplace#370