Mystery Generation

Patterns for structuring fair, solvable mysteries in middle-grade fiction — clue chains, red herrings, and fair-play validation.

Mystery Structure for Books

Every mystery story has these components:

interface MysteryDefinition {
  // The solution (revealed in final chapters)
  groundTruth: {
    victim: string;           // Who is missing/trapped/affected
    antagonist: string;       // The Mapmaker (revealed gradually)
    motive: string;          // Why Wonderland exists
    method: string;          // How the system works/traps people
    resolution: string;      // How Alex solves/escapes
  };

  // Discovery architecture
  primaryClueChain: ClueChain;     // Main evidence path readers follow
  secondaryClues: Clue[];          // Supporting evidence
  redHerrings: RedHerring[];       // Deliberately misleading clues
  revelationPoints: Revelation[];  // Major "aha!" moments per act

  // Story layers
  chapterMysteries: ChapterMystery[];  // 20 mini-mysteries (one per chapter)
  overarchingMystery: string;          // "What is Wonderland and how do I escape?"
  metaMystery: string;                 // "Who am I really?" (Alex's origin)

  // Quality validation
  fairPlayScore: number;               // 0-100, must be ≥ 80 for middle-grade
  ageAppropriate: boolean;             // No graphic content
}

Chapter-Level Mystery Architecture

Every chapter contains a micro-mystery that feeds the macro-mystery:

interface ChapterMystery {
  chapterNumber: number;
  title: string;
  
  // The chapter's puzzle
  mystery: string;                  // "Why does the Bell Tower ring backward?"
  cluesDiscovered: Clue[];         // Evidence Alex finds THIS chapter
  deductions: string[];            // Conclusions Alex reaches
  
  // Connection to overall mystery
  revealsAbout: string;            // What this teaches about Wonderland
  advancesPlot: string;            // How this moves story forward
  
  // Fair-play structure
  readerCanSolve: boolean;         // Can reader deduce answer from clues?
  solutionTiming: 'same-chapter' | 'later' | 'final-act';
}

Chapter Mystery Template

## Chapter [N]: [Title]

**Micro-Mystery**: [One-sentence question Alex must solve]

**Clues Introduced**:
1. [Clue 1] — [What it suggests]
2. [Clue 2] — [What it suggests]
3. [Clue 3] — [Hidden detail, requires re-reading]

**Deduction Path**:
Clue 1 + Clue 2 → [Intermediate conclusion]
+ Clue 3 → [Chapter revelation]

**Revelation**: [What Alex learns by chapter end]

**Unanswered Question**: [Hook for next chapter]

**Macro-Mystery Advancement**: [How this connects to Wonderland's true nature]

Clue Chain Building

A clue chain is a sequential path of evidence leading from discovery to solution.

Three-Clue Rule (Mystery Writing Principle)

For any deduction Alex makes, provide at least 3 clues so readers can:

1. •Notice the first clue (may miss it)
2. •Connect the second clue (pattern recognition)
3. •Confirm with the third (satisfying "aha!")

Clue Chain Levels

Difficulty Scaling (Middle-Grade Appropriate)

Clue Types for Books

Fair-Play Validation (Knox's Decalogue for Middle-Grade)

Every mystery MUST pass fair-play checks:

Fair-Play Scoring

interface FairPlayResult {
  score: number;          // 0-100
  violations: {
    rule: number;
    severity: 'critical' | 'warning';
    description: string;
    chapter: number;
  }[];
  passesMiddleGrade: boolean;  // score >= 80 + age-appropriate
}

Additional Middle-Grade Rules

• •✅ Clues match reading level: No obscure references young readers can't access
• •✅ Solvability timeline: Readers should solve final mystery by Chapter 18 (before Alex's Chapter 19 confrontation)
• •✅ Hopeful stakes: Tension without trauma; mystery is puzzle, not horror
• •✅ Earned revelations: Every twist has 3+ prior hints

Red Herring Placement

Red herrings misdirect without cheating:

Rules

• •Each red herring has a resolution — a way to disprove it
• •Red herrings should mislead about method or motive, not core mystery
• •At least one red herring disprovable per 5-chapter act
• •Red herrings create depth, not frustration

Types

Resolution Patterns

Every red herring must resolve by end of the act it appears in:

## Red Herring: [Misleading clue]

**Introduced**: Chapter [N]
**Misleads toward**: [Wrong conclusion]
**Resolved**: Chapter [N+3 to N+5]
**Resolution method**: [How Alex discovers the truth]
**Reader fairness**: [Clues to resolution present alongside red herring]

Revelation Architecture (Three-Act Structure)

Major Revelation Points

Clue Validation Checklist

Before finalizing a chapter, validate clues:

Per-Chapter Audit

• • Three-clue minimum: Any deduction has 3+ supporting clues
• • Reader access: Clues match middle-grade knowledge level
• • Fair timing: Clues appear before deduction, not after
• • Internal consistency: No contradictions with previous chapters
• • Breadcrumb trail: At least one clue pointing to next chapter mystery
• • Hidden depth: At least one subtle clue for re-readers
• • Red herring balance: Misleading clues have resolution path

Book-Level Audit

• • Complete chain: Path from Ch 1 to Ch 20 solution exists
• • Knox compliance: All 10 rules + middle-grade additions met
• • Solvability: Beta readers can solve by Ch 18
• • Re-readability: Second read reveals missed clues (not contradictions)
• • Meta-coherence: Alex's origin story clues woven throughout

Mystery Validation Workflow

## Chapter Mystery Validation

**Chapter**: [N]
**Mystery**: [One-sentence question]

### Clue Inventory
1. [Clue 1] — Type: [Physical/Verbal/etc], Visibility: [Obvious/Subtle/Hidden]
2. [Clue 2] — Type: [Physical/Verbal/etc], Visibility: [Obvious/Subtle/Hidden]
3. [Clue 3] — Type: [Physical/Verbal/etc], Visibility: [Obvious/Subtle/Hidden]

### Deduction Path

Clue 1 → [Observation]

• •Clue 2 → [Pattern]
• •Clue 3 → [Conclusion: Chapter revelation]

### Fair-Play Check
- [ ] All clues shown to reader before Alex deduces
- [ ] Clues are age-appropriate
- [ ] Alternative interpretations exist (prevents "too easy")
- [ ] Red herrings (if any) have resolution path
- [ ] Advances macro-mystery

### Connection to Overall Mystery
**Wonderland Rules**: [What this reveals about how Wonderland works]
**The Mapmaker**: [What this reveals about antagonist]
**Alex's Nature**: [What this reveals about meta-mystery]

### Reader Solvability
Can a middle-grade reader solve this micro-mystery with the given clues?
- [ ] Yes, with effort
- [ ] Only with Alex's guidance
- [ ] Too complex (revise/add clues)

Integration with Writing Process

Planning Phase (Before Writing Chapter)

1. •Define chapter micro-mystery
2. •List 3-5 clues that will appear
3. •Map clue → deduction path
4. •Identify macro-mystery connection
5. •Plan red herring (if any) + resolution

Writing Phase (During Chapter Draft)

1. •Show clues through Alex's narration (observational voice)
2. •Let Alex think through deductions (reflective voice)
3. •Include at least one missed clue (re-read value)
4. •End with unanswered question (chapter hook)

Revision Phase (After Chapter Draft)

1. •Run fair-play validation checklist
2. •Verify three-clue rule for all deductions
3. •Check reading level of clues
4. •Ensure red herrings (if any) have resolution path
5. •Confirm macro-mystery advancement

Synapses

Connection Mapping

• •[.github/skills/alex-finch-narrator/SKILL.md] (Critical, Integrates, Bidirectional) - "Mystery structure informs narrative pacing"
• •[.github/skills/creative-writing/SKILL.md] (High, Enables, Forward) - "Clue delivery through narrative craft"
• •[.github/skills/book-character-engine/SKILL.md] (High, Uses, Forward) - "Character knowledge affects clue discovery"
• •[outlines/story-outline.md] (Critical, Validates, Backward) - "Overall mystery structure guides chapter mysteries"
• •[chapters/*.md] (Critical, Validates, Bidirectional) - "Chapter outlines encode clue chains"
• •[docs/MYSTERY-VALIDATION-GUIDE.md] (High, Validates, Backward) - "Fair-play templates and checklists"

Activation Patterns

• •Planning chapter mystery → Load this skill + story outline
• •Validating clue chain → Load this skill, run fair-play checklist
• •Red herring design → Load this skill, focus on red herring section
• •Overall mystery audit → Load this + all chapter outlines
• •Middle-grade appropriateness check → Load this + Knox's rules

Mystery Generation — Fair-play mystery structure for middle-grade fiction