Document Validation Skill

Purpose: Validate workflow documents against template requirements Trigger: Called by reviewer agent before HITL approval Input: Document path, document type (prd | execution-plan | user-story) Output: {valid, document_type, issues[], checked_fields[], checked_sections[]}

Workflow

1. Detect Document Type

Pattern	Document Type
`project_id` in frontmatter	PRD
`total_stories` in frontmatter	Execution Plan
`story_id` in frontmatter	User Story

2. Parse Document

Extract YAML frontmatter (between --- markers)
Parse frontmatter fields
Extract markdown sections (H2 headers)

3. Validate Against Checklist

Run type-specific validation (see checklists below).

PRD Checklist

Frontmatter: project_id, title, version, status, owner, created, updated

Sections: ## 1. Executive Summary, ## 2. Problem Statement, ## 3. Solution Overview, ## 4. Requirements, ## 5. Scope, ## 6. Epic Summary, ## 7. Success Criteria

Execution Plan Checklist

Frontmatter: project_id, title, status, total_stories, total_complexity, total_waves, owner, created, updated

Sections: ## Summary, ## Wave Strategy Overview, ## User Stories Index, ## Wave N: (at least one)

User Story Checklist

Frontmatter: story_id, epic_id, title, status, complexity, wave, agent, dependencies, created, updated

Sections: ## User Story, ## Acceptance Criteria, ## Technical Details, ## Definition of Done

Issue Types

Issue Type	Description	Severity
`missing_field`	Required frontmatter field absent	CRITICAL
`missing_section`	Required markdown section absent	CRITICAL
`invalid_format`	Field value format incorrect	WARNING
`empty_section`	Section exists but empty	WARNING

Output Structure

{
  "valid": true|false,
  "document_type": "prd|execution-plan|user-story",
  "issues": [{"type": "...", "field|section": "...", "message": "..."}],
  "checked_fields": [{"field": "...", "status": "pass|fail"}],
  "checked_sections": [{"section": "...", "status": "pass|fail"}]
}

Integration

Called by: reviewer agent, hitl-approval skill, /ms command

References:

PRD template: ../prd-creation/templates/prd-template.md
Execution plan template: ../execution-plan-creation/templates/execution-plan-template.md
User story template: ../user-story-creation/templates/user-story-template.md

Next: Valid -> HITL approval; Invalid -> return to authoring agent

document-validation