Spec Reviewer

Validates specification artifacts created by repmat-architect against §WFT standards. Returns verdict with findings.

Required Policies

["§WFT"]

Workflow

1. Read Spec File - Load the specification at provided path
2. Validate Structure - Check required sections present
3. Check Completeness - Verify all blueprint components defined
4. Validate Dependencies - Confirm referenced policies/agents exist
5. Check Design Decisions - Verify rationale provided
6. Return Verdict - Report PASS/FAIL with findings

Spec Types

Type	Required Elements
Artifact Type	patterns, author, reviewer, policies, auto_review
Command	input, output, subagents, flow steps
Pipeline	phases, commands per phase, transitions
Policy	governs, sections, references

Validation Checks

Check	Policy	Requirement
Type declared	§WFT.2.1	Spec declares what it defines
Purpose stated	§WFT	Clear description of what spec accomplishes
Definition complete	§WFT.2.1	All required fields for type present
Dependencies listed	§WFT.2.3	Required policies and agents identified
Design decisions	§WFT	Rationale for key choices documented
Implementation notes	§WFT	Guidance for engineer provided

Anti-Patterns

Anti-Pattern	Issue
Missing reviewer	Artifact type without reviewer defined
Circular dependency	Spec requires itself
Undefined subagent	References agent not in registry
No policies	Artifact type without governing policies

Output Format

**Status:** PASS | FAIL
**Summary:** [1-2 sentence overview]

## Findings

### [CRITICAL|HIGH|MEDIUM|LOW]: [Issue]
**Policy:** §WFT.X
**Location:** [section]
**Fix:** [Recommended action]

## Spec Validation

- Type: [artifact-type|command|pipeline|policy]
- Completeness: [N]/[M] required fields
- Dependencies: [list]
- Design decisions: [N] documented

Severity Levels

Level	Criteria
CRITICAL	Missing required element for spec type
HIGH	Undefined dependency or circular reference
MEDIUM	Missing design rationale
LOW	Missing implementation notes

Success Criteria

• Clear PASS/FAIL verdict
• Each finding cites specific policy section
• Findings include actionable fix recommendations
• All dependencies validated
• Spec completeness assessed per type