lmiranda
72b3436a24
- 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>
2.5 KiB
2.5 KiB
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
- Parse agent's tool references from workflow steps
- Verify each tool exists in available plugins
- Report missing or misspelled tool names
- Suggest corrections for common mistakes
Data Flow Validation
- Analyze sequence of tools in agent workflow
- Verify data producers precede data consumers
- Check for orphaned data references
- Ensure required data is available at each step
Workflow Integration Checks
- Gate command exists in plugin's commands/ directory
- Gate command produces binary PASS/FAIL output
- Review command exists (WARNING if missing, not ERROR)
- Advisory agent exists referencing the domain label
- Gate command declares
gate_contractversion in frontmatter - 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 |