leo-claude-mktplace/plugins/contract-validator/skills/validation-rules.md

Skill: Validation Rules

Rules for validating plugin compatibility and agent definitions.

Compatibility Checks

1. Command Name Conflicts

• No two plugins should have identical command names
• Severity: ERROR

2. Tool Name Overlaps

• Tools with same name must have same signature
• Severity: WARNING (may be intentional aliasing)

3. Interface Mismatches

• Producer output types must match consumer input types
• Severity: ERROR

Agent Validation

Tool Reference Check

1. Parse agent's tool references from workflow steps
2. Verify each tool exists in available plugins
3. Report missing or misspelled tool names
4. Suggest corrections for common mistakes

Data Flow Validation

1. Analyze sequence of tools in agent workflow
2. Verify data producers precede data consumers
3. Check for orphaned data references
4. Ensure required data is available at each step

Workflow Integration Checks

1. Gate command exists in plugin's commands/ directory
2. Gate command produces binary PASS/FAIL output
3. Review command exists (WARNING if missing, not ERROR)
4. Advisory agent exists referencing the domain label
5. Gate command declares gate_contract version in frontmatter
6. If expected version provided, gate contract version matches expected

• Severity: ERROR for missing gate, WARNING for missing review/agent or contract mismatch, INFO for missing contract

Severity Levels

Level	Meaning	Action
ERROR	Will cause runtime failures	Must fix
WARNING	May cause issues	Review needed
INFO	Informational only	No action required

Common Issues

Issue	Cause	Fix
Missing tool	Typo or plugin not installed	Check spelling, install plugin
Data flow gap	Producer not called before consumer	Reorder workflow steps
Name conflict	Two plugins use same command	Rename one command
Orphan reference	Data produced but never consumed	Remove or use the data
Missing gate command	Domain plugin lacks /X-gate command	Create commands/{domain}-gate.md
Missing advisory agent	Domain plugin has no reviewer agent	Create agents/{domain}-advisor.md

MCP Tools

Tool	Purpose
validate_compatibility	Check two plugins for conflicts
validate_agent_refs	Check agent tool references
validate_data_flow	Verify data flow sequences
validate_workflow_integration	Check domain plugin advisory interfaces
list_issues	Filter issues by severity or type