claude-plugins/fiction-assistance/commands/generate/validate-story.md

description, allowed-tools

description	allowed-tools
Validate story consistency and find issues	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:

# 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.