feat(fiction-assistance): register plugin with full bespoke command set
Snapshot of the fiction-assistance plugin in its original Universalis- specific form before generalization. Adds the missing plugin.json manifest (subdirectory command paths explicitly listed), moves the two stray root-level review files into their proper homes (review-all.md into the reviewing-fiction skill, review-final.md as a command with frontmatter), and registers the plugin in the marketplace. Preserved here so the original card-generation and vault-maintenance commands remain recoverable when the plugin is reduced to a portable guidance-and-analysis subset in the next commit. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
154
fiction-assistance/commands/generate/validate-story.md
Normal file
154
fiction-assistance/commands/generate/validate-story.md
Normal file
@@ -0,0 +1,154 @@
|
||||
---
|
||||
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.
|
||||
Reference in New Issue
Block a user