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>
70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
# 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 |
|