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:
movq
2026-05-16 18:24:15 -05:00
parent 87b6bb1d8c
commit 65c29d795b
31 changed files with 3260 additions and 0 deletions

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