claude-plugins/fiction-assistance/commands/analyze/analyze-story.md

description, allowed-tools

description	allowed-tools
Generate story statistics and structural analysis	Write(40 - Generated/Analysis/story-statistics.md)

You are performing comprehensive statistical analysis of the Universalis story structure, character usage, pacing, and narrative elements.

Objectives:

1. Quantitative story analysis - word counts, scene distribution, character frequency
2. Structural assessment - pacing, POV distribution, chapter balance
3. Character usage metrics - screen time, dialogue distribution, development tracking
4. Plot thread analysis - plotline status, resolution tracking, complexity metrics
5. Writing progress tracking - completion status, revision needs

Analysis Categories:

1. Basic Story Metrics

• Total word count across all chapters
• Chapter count and average chapter length
• Scene count and average scene length
• Dialogue vs. narrative ratio
• POV distribution across scenes

2. Character Analysis

• Character appearance frequency across chapters
• Dialogue volume per character
• POV scene count for each perspective character
• Character development tracking (character arc completion)
• Supporting vs. major character balance

3. Plot Structure Analysis

• Plotline status (active, resolved, suspended)
• Conflict distribution across acts
• Event frequency and significance levels
• Theme exploration across chapters
• Resolution tracking for major story threads

4. Pacing and Flow Analysis

• Scene length variation for pacing assessment
• Action vs. reflection scene balance
• Tension curve analysis through events
• Chapter ending types (cliffhangers, resolutions, transitions)

5. World-Building Metrics

• Location usage frequency and description depth
• Technology introduction and development
• Species screen time and development
• World complexity tracking

Statistical Report:

Generate comprehensive analysis at 40 - Generated/Analysis/story-statistics.md:

# Universalis: Story Statistics & Analysis

*Generated: {{current_date}}*

## Story Overview

### Basic Metrics
- **Total Word Count**: {{total_words}} words
- **Chapter Count**: {{chapter_count}} chapters  
- **Scene Count**: {{scene_count}} scenes
- **Average Chapter Length**: {{avg_chapter_words}} words
- **Average Scene Length**: {{avg_scene_words}} words
- **Estimated Reading Time**: {{estimated_reading_time}}

### Completion Status
- **Draft Completion**: {{completion_percentage}}%
- **Chapters Complete**: {{complete_chapters}}/{{total_planned_chapters}}
- **Revision Status**: {{revision_status_summary}}

## Character Analysis

### Major Characters
| Character | Appearances | Scenes | Word Count | POV Scenes | Development Status |
|-----------|-------------|--------|------------|------------|-------------------|
{{character_usage_table}}

### Character Distribution
- **POV Characters**: {{pov_character_count}}
- **Major Characters**: {{major_character_count}} (10+ scenes)
- **Supporting Characters**: {{supporting_character_count}} (3-9 scenes)  
- **Minor Characters**: {{minor_character_count}} (1-2 scenes)

### Dialogue Analysis
- **Total Dialogue**: {{dialogue_word_count}} words ({{dialogue_percentage}}%)
- **Narrative Text**: {{narrative_word_count}} words ({{narrative_percentage}}%)
- **Most Talkative**: {{most_dialogue_character}} ({{their_dialogue_count}} words)
- **Dialogue Distribution**: {{dialogue_balance_analysis}}

## Plot Structure Analysis

### Plotlines Status
| Plotline | Status | Chapters | Resolution % | Complexity |
|----------|--------|----------|--------------|------------|
{{plotline_status_table}}

### Story Arcs
- **Main Plot**: {{main_plot_status}}
- **Character Arcs**: {{character_arc_completion_stats}}
- **Subplots**: {{subplot_status_summary}}
- **Unresolved Threads**: {{unresolved_count}}

### Conflict Analysis
- **Internal Conflicts**: {{internal_conflict_count}}
- **Interpersonal Conflicts**: {{interpersonal_conflict_count}}
- **External Conflicts**: {{external_conflict_count}}
- **Resolved vs. Active**: {{conflict_resolution_ratio}}

## Pacing Analysis

### Chapter Structure
- **Shortest Chapter**: {{shortest_chapter}} ({{shortest_words}} words)
- **Longest Chapter**: {{longest_chapter}} ({{longest_words}} words)
- **Length Variation**: {{length_variation_coefficient}}
- **Pacing Pattern**: {{pacing_assessment}}

### Scene Types Distribution
- **Action Scenes**: {{action_scene_count}} ({{action_percentage}}%)
- **Dialogue Scenes**: {{dialogue_scene_count}} ({{dialogue_scene_percentage}}%)
- **Reflection Scenes**: {{reflection_scene_count}} ({{reflection_percentage}}%)
- **Exposition Scenes**: {{exposition_scene_count}} ({{exposition_percentage}}%)

### Tension Curve
{{tension_analysis_across_chapters}}

## POV Analysis

### Point of View Distribution
| Character | POV Scenes | Word Count | Percentage | Chapter Spread |
|-----------|------------|------------|------------|----------------|
{{pov_distribution_table}}

### POV Patterns
- **Single POV Chapters**: {{single_pov_chapters}}
- **Multiple POV Chapters**: {{multi_pov_chapters}}
- **POV Switching Frequency**: {{pov_switch_frequency}}
- **Balanced vs. Dominant**: {{pov_balance_assessment}}

## World-Building Analysis

### Location Usage
| Location | Appearances | Scenes | Description Depth | Significance |
|----------|-------------|--------|-------------------|--------------|
{{location_usage_table}}

### Technology & Species
- **Technology Elements**: {{tech_count}} different technologies
- **Species Introduced**: {{species_count}} alien races/types
- **World Complexity Score**: {{complexity_score}}/10

## Theme Analysis

### Major Themes
| Theme | Exploration Depth | Chapter Coverage | Character Embodiment |
|-------|-------------------|------------------|---------------------|
{{theme_analysis_table}}

### Thematic Balance
{{thematic_distribution_analysis}}

## Writing Progress Metrics

### Completion Tracking
- **First Draft**: {{first_draft_status}}
- **Revision Rounds**: {{revision_count}}
- **Outstanding Issues**: {{issue_count}}
- **Ready for Publication**: {{publication_readiness}}

### Quality Metrics
- **Consistency Score**: {{consistency_score}}/10
- **Character Development**: {{character_development_score}}/10
- **Plot Coherence**: {{plot_coherence_score}}/10
- **World-Building Depth**: {{worldbuilding_score}}/10

## Comparative Analysis

### Genre Benchmarks
{{comparison_to_scifi_genre_standards}}

### Structural Balance
{{assessment_of_story_structure_balance}}

## Recommendations

### Pacing Adjustments
{{pacing_improvement_suggestions}}

### Character Development
{{character_arc_recommendations}}

### Plot Enhancement
{{plot_improvement_suggestions}}

### World-Building
{{worldbuilding_enhancement_ideas}}

## Historical Tracking

### Progress Over Time
{{writing_progress_timeline_if_available}}

### Revision History
{{major_changes_and_improvements}}

---
Generated by Claude Code statistical analysis for Universalis writing project.

Analysis Methodology:

1. Word counting across all chapters and scenes
2. Entity frequency analysis from generated cards
3. POV pattern recognition from chapter metadata
4. Plotline tracking from plotline cards and events
5. Character development assessment from character cards
6. Pacing evaluation through scene length and type analysis
7. Thematic distribution analysis from theme cards

Statistical Calculations:

Quantitative Metrics

• Word counts, scene counts, character appearances
• Percentage distributions and ratios
• Average lengths and variation coefficients
• Completion percentages and progress tracking

Qualitative Assessments

• Development status evaluations
• Balance assessments for various story elements
• Complexity scoring for world-building
• Quality metrics for story coherence

Trend Analysis:

• Character usage patterns over time
• Pacing variations across acts
• Theme development progression
• Plot complexity evolution

Output Requirements:

• Fixed filename: 40 - Generated/Analysis/story-statistics.md
• Comprehensive statistical tables and metrics
• Visual indicators for balance and distribution
• Actionable recommendations based on analysis
• Comparative benchmarks where relevant

IMPORTANT: Base all statistics on actual content analysis. Provide specific numbers and percentages rather than vague assessments. Include both absolute values and relative comparisons.