---
description: Validate story consistency and find issues
allowed-tools: Write(40 - Generated/Analysis/validation-report.md)
---
You are performing comprehensive validation of the Universalis story world for consistency and completeness.

## Objectives:

1. **Find missing cross-references** between generated cards
2. **Identify orphaned files** with no incoming links
3. **Detect formatting inconsistencies** across cards
4. **Flag mentioned but undocumented entities**
5. **Validate frontmatter completeness**

## Validation Checks:

### 1. Cross-Reference Validation
- **Broken Links**: Find `[[filename.md]]` links pointing to non-existent files
- **Missing Backlinks**: Characters mentioned in events but not linked back
- **Orphaned Entities**: Cards with no incoming references from other cards
- **One-Way Links**: A links to B, but B doesn't mention A when it should

### 2. Frontmatter Consistency
Check each card type for:
- **Required fields present**: name, type, tags, created, modified
- **Valid values**: status fields use allowed values
- **Consistent formatting**: dates in correct format
- **Complete relationships**: appearances list matches actual chapter mentions

### 3. Content Validation
- **Empty sections**: Required sections with no content
- **Inconsistent naming**: Same entity referenced with different names
- **Missing first-mention links**: Entities mentioned but not linked
- **Duplicate content**: Similar descriptions across multiple cards

### 4. Entity Coverage
Scan chapters for:
- **Undocumented characters**: Names mentioned but no character card exists
- **Undocumented locations**: Places mentioned but no location card
- **Undocumented technology**: Tech mentioned but no tech card
- **Undocumented species**: Races mentioned but no species card

### 5. Structural Issues
- **File naming**: Inconsistent filename conventions
- **Directory structure**: Files in wrong categories
- **Markdown formatting**: Headers, lists, frontmatter syntax
- **Link syntax**: Malformed wiki-style links

## Report Generation:

Create comprehensive report at `40 - Generated/Analysis/validation-report.md`:

```markdown
# Story Validation Report

*Generated: {{current_date}}*

## Summary
- **Total Issues Found**: {{total_issue_count}}
- **Critical Issues**: {{critical_count}} (broken links, missing entities)
- **Warning Issues**: {{warning_count}} (formatting, minor inconsistencies)
- **Info Issues**: {{info_count}} (suggestions, optimizations)

## Critical Issues

### Broken Links
{{list_broken_links_with_sources}}

### Missing Entity Cards
Characters mentioned in chapters but no card exists:
{{list_missing_characters}}

Locations mentioned but no card exists:
{{list_missing_locations}}

[Continue for other entity types]

### Orphaned Files
Cards with no incoming references:
{{list_orphaned_files}}

## Warning Issues

### Frontmatter Issues
{{list_frontmatter_problems}}

### Formatting Inconsistencies
{{list_formatting_issues}}

### Missing Cross-References
{{list_missing_links}}

## Info Issues

### Content Suggestions
{{list_content_suggestions}}

### Optimization Opportunities
{{list_optimizations}}

## Validation Details

### Files Checked
- **Total Generated Files**: {{total_file_count}}
- **Character Cards**: {{character_file_count}}
- **Location Cards**: {{location_file_count}}
- **Ship Cards**: {{ship_file_count}}
- **Technology Cards**: {{tech_file_count}}
- **Species Cards**: {{species_file_count}}
- **Plotline Cards**: {{plotline_file_count}}
- **Event Cards**: {{event_file_count}}
- **Conflict Cards**: {{conflict_file_count}}
- **Theme Cards**: {{theme_file_count}}

### Chapter Coverage
{{list_chapters_with_coverage_stats}}

## Recommendations

### Immediate Actions
{{list_critical_fixes}}

### Quality Improvements
{{list_quality_suggestions}}

### Future Enhancements
{{list_enhancement_ideas}}

---
Generated by Claude Code validation system for Universalis writing project.
```

## Validation Methodology:

1. **Inventory all files** in 40 - Generated/
2. **Extract all links** from each file (frontmatter + content)
3. **Cross-reference entities** mentioned across files
4. **Scan chapters** for entity mentions
5. **Compare coverage** between manuscript chapters and generated cards
6. **Check formatting** against established patterns
7. **Generate prioritized issue list**

## Issue Severity:
- **Critical**: Broken functionality (broken links, missing required entities)
- **Warning**: Inconsistencies that affect quality (formatting, incomplete data)
- **Info**: Suggestions for improvement (optimization opportunities)

## Output Requirements:
- Fixed filename: `40 - Generated/Analysis/validation-report.md`
- Structured sections for different issue types
- Actionable recommendations with specific file references
- Summary statistics for tracking improvement over time

**IMPORTANT**: Provide specific file references and line numbers where possible to make issues easy to fix.