@mytechtoday/augment-extensions 0.7.0 → 1.2.1

package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md

@@ -1,293 +1,293 @@
-# Mystery Genre
-
-**Category**: Screenplay Genre  
-**Type**: Primary  
-**Complexity**: High
-
-## Overview
-
-Mystery films center on solving a puzzle, crime, or enigma through investigation and deduction. The genre emphasizes clues, red herrings, revelations, and the satisfaction of piecing together the truth.
-
-## Core Concept
-
-Mystery screenplays are intellectual puzzles where the audience follows an investigator (professional or amateur) as they uncover the truth. Success depends on fair play with clues, satisfying revelations, and maintaining suspense about the solution. Great mysteries engage the audience as active participants trying to solve the puzzle alongside the protagonist.
-
-## Core Rules
-
-### Rule 1: Play Fair with Clues
-
-**Description**: All information needed to solve the mystery must be available to the audience, even if cleverly hidden or disguised.
-
-**Why It Matters**: Mysteries are puzzles. Solutions pulled from nowhere feel like cheating and frustrate audiences.
-
-**Examples**:
-- ✅ **Good**: Crucial clue shown early but its significance only becomes clear later
-- ❌ **Bad**: Killer revealed to be character never mentioned or shown before
-
-**Film Reference**: Knives Out (2019) - All clues are visible; the fun is in how they're interpreted.
-
----
-
-### Rule 2: Misdirect, Don't Mislead
-
-**Description**: Use red herrings and false leads to create suspense, but don't lie to the audience or withhold crucial information unfairly.
-
-**Why It Matters**: Misdirection is artful; misleading is dishonest. The audience should be able to solve it with careful attention.
-
-**Examples**:
-- ✅ **Good**: Suspicious character with motive who turns out to be innocent
-- ❌ **Bad**: Showing events that didn't actually happen to trick the audience
-
-**Film Reference**: The Usual Suspects (1995) - Misdirection through unreliable narrator, but clues to the truth are present.
-
----
-
-### Rule 3: Make the Detective Active
-
-**Description**: The protagonist must drive the investigation through intelligence, observation, and action, not luck or coincidence.
-
-**Why It Matters**: Passive detectives make boring mysteries. The audience wants to see clever deduction and persistence.
-
-**Examples**:
-- ✅ **Good**: Detective notices small detail, follows logical chain of reasoning, takes risks to uncover truth
-- ❌ **Bad**: Clues fall into detective's lap through coincidence; villain confesses for no reason
-
-**Film Reference**: Zodiac (2007) - Obsessive investigation through painstaking research and deduction.
-
----
-
-### Rule 4: Escalate the Stakes
-
-**Description**: As the investigation progresses, the danger, urgency, or personal cost should increase.
-
-**Why It Matters**: Pure puzzle-solving can feel academic. Rising stakes create emotional investment.
-
-**Examples**:
-- ✅ **Good**: Detective gets closer to truth, killer targets them or loved ones
-- ❌ **Bad**: Investigation proceeds with no consequences or increasing danger
-
-**Film Reference**: Se7en (1995) - Each discovery is more horrific; killer's plan targets the detectives personally.
-
----
-
-### Rule 5: Deliver a Satisfying Revelation
-
-**Description**: The solution should be surprising yet inevitable - it makes perfect sense in hindsight and recontextualizes earlier events.
-
-**Why It Matters**: The reveal is the payoff. It must feel earned, logical, and emotionally satisfying.
-
-**Examples**:
-- ✅ **Good**: "I should have seen it!" - clues were there, solution is elegant
-- ❌ **Bad**: Random, illogical solution or overly complicated explanation
-
-**Film Reference**: The Sixth Sense (1999) - Twist recontextualizes entire film; clues were always visible.
-
----
-
-## Guidelines
-
-### Structure
-
-- **Act I**: Crime/mystery introduced, detective takes the case, initial investigation and suspects
-- **Act II**: Following leads, interviewing suspects, discovering clues, red herrings, false solutions, investigation deepens
-- **Act III**: Final pieces fall into place, confrontation with culprit, revelation and explanation, resolution
-
-### Pacing
-
-- Hook with intriguing mystery early
-- Dole out clues and revelations steadily
-- Use setbacks and false leads to maintain tension
-- Accelerate as solution approaches
-- Allow time for explanation without dragging
-
-### Character Archetypes
-
-- **Protagonist**: Detective (professional or amateur), journalist, or ordinary person drawn into mystery
-- **Antagonist**: Killer, criminal, or person hiding the truth
-- **Supporting**: Police/authority, suspects (each with motive/opportunity), informant, victim's family
-
-### Tone and Atmosphere
-
-- Intellectual engagement and curiosity
-- Suspense and unease
-- Can range from cozy (Agatha Christie) to dark (noir)
-- Atmosphere of secrets and hidden truths
-- Satisfaction of puzzle-solving
-
-### Visual Style
-
-- Use of shadows and obscured details
-- Visual clues hidden in frame
-- Flashbacks to show new perspective on events
-- Close-ups on important details
-- Contrast between surface appearance and hidden truth
-
-### Dialogue
-
-- Interrogation and questioning
-- Subtext - characters hiding information
-- Deductive reasoning explained clearly but not condescendingly
-- Revelations through conversation
-- Avoid over-explaining; trust audience intelligence
-
-## Common Pitfalls
-
-### Pitfall 1: Withholding Information Unfairly
-
-**Problem**: Keeping crucial information from the audience so they can't possibly solve the mystery.
-
-**Solution**: Show all clues, even if their significance isn't immediately clear. Fair play is essential.
-
-**Example**: Murder on the Orient Express - All clues are presented; the solution is in how they're interpreted.
-
----
-
-### Pitfall 2: Overly Complicated Solution
-
-**Problem**: Solution requires such convoluted logic or coincidences that it strains credibility.
-
-**Solution**: Keep solution elegant and logical. Complexity should come from misdirection, not convolution.
-
-**Example**: Knives Out - Complex plot but solution is ultimately straightforward and satisfying.
-
----
-
-### Pitfall 3: Passive Investigation
-
-**Problem**: Detective stumbles onto clues by accident rather than through active investigation and deduction.
-
-**Solution**: Show detective's intelligence and methodology. Clues should be discovered through effort and insight.
-
-**Example**: Sherlock Holmes films - Holmes actively seeks clues through observation and deduction.
-
----
-
-## Film Examples
-
-### Example 1: Chinatown (1974)
-
-**Director**: Roman Polanski
-
-**Why It Works**: Noir mystery with layers of corruption, personal stakes, and tragic revelation. Perfect pacing and atmosphere.
-
-**Key Scenes**:
-- **Water Department Investigation**: Following seemingly simple case into deeper conspiracy
-- **"She's my sister AND my daughter"**: Horrific revelation that recontextualizes everything
-- **Tragic Ending**: Truth revealed but justice denied
-
-**Techniques Used**:
-- Protagonist discovers truth gradually through investigation
-- Each revelation leads to darker truth
-- Personal involvement raises stakes
-- Noir atmosphere of corruption and moral ambiguity
-
----
-
-### Example 2: Knives Out (2019)
-
-**Director**: Rian Johnson
-
-**Why It Works**: Modern whodunit with clever structure - reveals "who" early, then explores "how" and "why."
-
-**Key Scenes**:
-- **Murder Night**: Multiple perspectives on same events
-- **Marta's Interrogation**: Literal inability to lie creates unique dynamic
-- **Ransom's Reveal**: Twist on top of twist, all clues were present
-
-**Techniques Used**:
-- Subverts traditional mystery structure
-- Fair play with all clues visible
-- Ensemble cast of suspects with motives
-- Social commentary woven into mystery
-
----
-
-### Example 3: The Usual Suspects (1995)
-
-**Director**: Bryan Singer
-
-**Why It Works**: Unreliable narrator mystery where the telling of the story is the mystery itself.
-
-**Key Scenes**:
-- **Lineup**: Introduction of criminals with mysterious connection
-- **Verbal's Story**: Flashback narrative that may or may not be true
-- **Coffee Cup Reveal**: Visual clues to unreliable narration throughout
-
-**Techniques Used**:
-- Unreliable narrator as misdirection
-- Visual clues hidden in plain sight
-- Twist ending that recontextualizes entire film
-- Fair play - clues to truth are present
-
----
-
-### Example 4: Zodiac (2007)
-
-**Director**: David Fincher
-
-**Why It Works**: Procedural mystery about obsession with unsolved case. Tension from lack of resolution.
-
-**Key Scenes**:
-- **Lake Berryessa**: Brutal crime that drives investigation
-- **Basement Scene**: Suspense from potential danger during investigation
-- **Cartoonist's Obsession**: Personal cost of seeking truth
-
-**Techniques Used**:
-- Realistic procedural detail
-- Multiple investigators with different approaches
-- Obsession as theme
-- Ambiguous ending mirrors real unsolved case
-
----
-
-## Integration with Other Features
-
-### Compatible Themes
-
-- **Truth vs. Lies**: Uncovering what's hidden
-- **Justice**: Solving crime to bring closure
-- **Obsession**: Compulsion to solve the puzzle
-- **Corruption**: Systemic cover-ups and conspiracies
-- **Identity**: Who people really are beneath surface
-
-### Compatible Styles
-
-- **Whodunit**: Classic puzzle mystery (Agatha Christie style)
-- **Noir**: Dark, cynical detective stories
-- **Procedural**: Realistic investigation methods
-- **Cozy Mystery**: Lighter, often amateur detective
-
-### Hybrid Combinations
-
-- **Mystery + Thriller**: Suspense with puzzle-solving (Gone Girl, The Girl with the Dragon Tattoo)
-- **Mystery + Horror**: Supernatural or slasher mystery (The Wicker Man, Scream)
-- **Mystery + Comedy**: Light-hearted whodunit (Clue, Murder Mystery)
-- **Mystery + Sci-Fi**: Futuristic or speculative mystery (Minority Report, Blade Runner)
-
-## Best Practices
-
-1. **Plant Clues Early**: Foreshadow solution without telegraphing it
-2. **Fair Play**: Audience should be able to solve it with careful attention
-3. **Red Herrings**: Misdirect but don't mislead
-4. **Active Detective**: Protagonist drives investigation through intelligence
-5. **Escalate Stakes**: Increase danger and urgency as truth approaches
-6. **Satisfying Reveal**: Surprising yet inevitable solution
-7. **Clear Explanation**: Ensure audience understands solution without over-explaining
-8. **Rewatch Value**: Solution should recontextualize earlier scenes
-9. **Character Depth**: Mystery serves character development, not just plot
-10. **Respect Intelligence**: Trust audience to follow complex plotting
-
-## Resources
-
-- "Writing the Mystery" by G. Miki Hayden
-- "How to Write a Mystery" edited by Lee Child - Essays from mystery authors
-- "Chinatown" screenplay by Robert Towne - Masterclass in noir mystery
-- "The Big Sleep" by Raymond Chandler - Classic detective novel structure
-- "And Then There Were None" by Agatha Christie - Perfect closed-circle mystery
-
----
-
-**Depth Coverage**: 85%
-**Last Updated**: 2026-01-31
-**Version**: 1.0.0
-
+# Mystery Genre
+
+**Category**: Screenplay Genre  
+**Type**: Primary  
+**Complexity**: High
+
+## Overview
+
+Mystery films center on solving a puzzle, crime, or enigma through investigation and deduction. The genre emphasizes clues, red herrings, revelations, and the satisfaction of piecing together the truth.
+
+## Core Concept
+
+Mystery screenplays are intellectual puzzles where the audience follows an investigator (professional or amateur) as they uncover the truth. Success depends on fair play with clues, satisfying revelations, and maintaining suspense about the solution. Great mysteries engage the audience as active participants trying to solve the puzzle alongside the protagonist.
+
+## Core Rules
+
+### Rule 1: Play Fair with Clues
+
+**Description**: All information needed to solve the mystery must be available to the audience, even if cleverly hidden or disguised.
+
+**Why It Matters**: Mysteries are puzzles. Solutions pulled from nowhere feel like cheating and frustrate audiences.
+
+**Examples**:
+- ✅ **Good**: Crucial clue shown early but its significance only becomes clear later
+- ❌ **Bad**: Killer revealed to be character never mentioned or shown before
+
+**Film Reference**: Knives Out (2019) - All clues are visible; the fun is in how they're interpreted.
+
+---
+
+### Rule 2: Misdirect, Don't Mislead
+
+**Description**: Use red herrings and false leads to create suspense, but don't lie to the audience or withhold crucial information unfairly.
+
+**Why It Matters**: Misdirection is artful; misleading is dishonest. The audience should be able to solve it with careful attention.
+
+**Examples**:
+- ✅ **Good**: Suspicious character with motive who turns out to be innocent
+- ❌ **Bad**: Showing events that didn't actually happen to trick the audience
+
+**Film Reference**: The Usual Suspects (1995) - Misdirection through unreliable narrator, but clues to the truth are present.
+
+---
+
+### Rule 3: Make the Detective Active
+
+**Description**: The protagonist must drive the investigation through intelligence, observation, and action, not luck or coincidence.
+
+**Why It Matters**: Passive detectives make boring mysteries. The audience wants to see clever deduction and persistence.
+
+**Examples**:
+- ✅ **Good**: Detective notices small detail, follows logical chain of reasoning, takes risks to uncover truth
+- ❌ **Bad**: Clues fall into detective's lap through coincidence; villain confesses for no reason
+
+**Film Reference**: Zodiac (2007) - Obsessive investigation through painstaking research and deduction.
+
+---
+
+### Rule 4: Escalate the Stakes
+
+**Description**: As the investigation progresses, the danger, urgency, or personal cost should increase.
+
+**Why It Matters**: Pure puzzle-solving can feel academic. Rising stakes create emotional investment.
+
+**Examples**:
+- ✅ **Good**: Detective gets closer to truth, killer targets them or loved ones
+- ❌ **Bad**: Investigation proceeds with no consequences or increasing danger
+
+**Film Reference**: Se7en (1995) - Each discovery is more horrific; killer's plan targets the detectives personally.
+
+---
+
+### Rule 5: Deliver a Satisfying Revelation
+
+**Description**: The solution should be surprising yet inevitable - it makes perfect sense in hindsight and recontextualizes earlier events.
+
+**Why It Matters**: The reveal is the payoff. It must feel earned, logical, and emotionally satisfying.
+
+**Examples**:
+- ✅ **Good**: "I should have seen it!" - clues were there, solution is elegant
+- ❌ **Bad**: Random, illogical solution or overly complicated explanation
+
+**Film Reference**: The Sixth Sense (1999) - Twist recontextualizes entire film; clues were always visible.
+
+---
+
+## Guidelines
+
+### Structure
+
+- **Act I**: Crime/mystery introduced, detective takes the case, initial investigation and suspects
+- **Act II**: Following leads, interviewing suspects, discovering clues, red herrings, false solutions, investigation deepens
+- **Act III**: Final pieces fall into place, confrontation with culprit, revelation and explanation, resolution
+
+### Pacing
+
+- Hook with intriguing mystery early
+- Dole out clues and revelations steadily
+- Use setbacks and false leads to maintain tension
+- Accelerate as solution approaches
+- Allow time for explanation without dragging
+
+### Character Archetypes
+
+- **Protagonist**: Detective (professional or amateur), journalist, or ordinary person drawn into mystery
+- **Antagonist**: Killer, criminal, or person hiding the truth
+- **Supporting**: Police/authority, suspects (each with motive/opportunity), informant, victim's family
+
+### Tone and Atmosphere
+
+- Intellectual engagement and curiosity
+- Suspense and unease
+- Can range from cozy (Agatha Christie) to dark (noir)
+- Atmosphere of secrets and hidden truths
+- Satisfaction of puzzle-solving
+
+### Visual Style
+
+- Use of shadows and obscured details
+- Visual clues hidden in frame
+- Flashbacks to show new perspective on events
+- Close-ups on important details
+- Contrast between surface appearance and hidden truth
+
+### Dialogue
+
+- Interrogation and questioning
+- Subtext - characters hiding information
+- Deductive reasoning explained clearly but not condescendingly
+- Revelations through conversation
+- Avoid over-explaining; trust audience intelligence
+
+## Common Pitfalls
+
+### Pitfall 1: Withholding Information Unfairly
+
+**Problem**: Keeping crucial information from the audience so they can't possibly solve the mystery.
+
+**Solution**: Show all clues, even if their significance isn't immediately clear. Fair play is essential.
+
+**Example**: Murder on the Orient Express - All clues are presented; the solution is in how they're interpreted.
+
+---
+
+### Pitfall 2: Overly Complicated Solution
+
+**Problem**: Solution requires such convoluted logic or coincidences that it strains credibility.
+
+**Solution**: Keep solution elegant and logical. Complexity should come from misdirection, not convolution.
+
+**Example**: Knives Out - Complex plot but solution is ultimately straightforward and satisfying.
+
+---
+
+### Pitfall 3: Passive Investigation
+
+**Problem**: Detective stumbles onto clues by accident rather than through active investigation and deduction.
+
+**Solution**: Show detective's intelligence and methodology. Clues should be discovered through effort and insight.
+
+**Example**: Sherlock Holmes films - Holmes actively seeks clues through observation and deduction.
+
+---
+
+## Film Examples
+
+### Example 1: Chinatown (1974)
+
+**Director**: Roman Polanski
+
+**Why It Works**: Noir mystery with layers of corruption, personal stakes, and tragic revelation. Perfect pacing and atmosphere.
+
+**Key Scenes**:
+- **Water Department Investigation**: Following seemingly simple case into deeper conspiracy
+- **"She's my sister AND my daughter"**: Horrific revelation that recontextualizes everything
+- **Tragic Ending**: Truth revealed but justice denied
+
+**Techniques Used**:
+- Protagonist discovers truth gradually through investigation
+- Each revelation leads to darker truth
+- Personal involvement raises stakes
+- Noir atmosphere of corruption and moral ambiguity
+
+---
+
+### Example 2: Knives Out (2019)
+
+**Director**: Rian Johnson
+
+**Why It Works**: Modern whodunit with clever structure - reveals "who" early, then explores "how" and "why."
+
+**Key Scenes**:
+- **Murder Night**: Multiple perspectives on same events
+- **Marta's Interrogation**: Literal inability to lie creates unique dynamic
+- **Ransom's Reveal**: Twist on top of twist, all clues were present
+
+**Techniques Used**:
+- Subverts traditional mystery structure
+- Fair play with all clues visible
+- Ensemble cast of suspects with motives
+- Social commentary woven into mystery
+
+---
+
+### Example 3: The Usual Suspects (1995)
+
+**Director**: Bryan Singer
+
+**Why It Works**: Unreliable narrator mystery where the telling of the story is the mystery itself.
+
+**Key Scenes**:
+- **Lineup**: Introduction of criminals with mysterious connection
+- **Verbal's Story**: Flashback narrative that may or may not be true
+- **Coffee Cup Reveal**: Visual clues to unreliable narration throughout
+
+**Techniques Used**:
+- Unreliable narrator as misdirection
+- Visual clues hidden in plain sight
+- Twist ending that recontextualizes entire film
+- Fair play - clues to truth are present
+
+---
+
+### Example 4: Zodiac (2007)
+
+**Director**: David Fincher
+
+**Why It Works**: Procedural mystery about obsession with unsolved case. Tension from lack of resolution.
+
+**Key Scenes**:
+- **Lake Berryessa**: Brutal crime that drives investigation
+- **Basement Scene**: Suspense from potential danger during investigation
+- **Cartoonist's Obsession**: Personal cost of seeking truth
+
+**Techniques Used**:
+- Realistic procedural detail
+- Multiple investigators with different approaches
+- Obsession as theme
+- Ambiguous ending mirrors real unsolved case
+
+---
+
+## Integration with Other Features
+
+### Compatible Themes
+
+- **Truth vs. Lies**: Uncovering what's hidden
+- **Justice**: Solving crime to bring closure
+- **Obsession**: Compulsion to solve the puzzle
+- **Corruption**: Systemic cover-ups and conspiracies
+- **Identity**: Who people really are beneath surface
+
+### Compatible Styles
+
+- **Whodunit**: Classic puzzle mystery (Agatha Christie style)
+- **Noir**: Dark, cynical detective stories
+- **Procedural**: Realistic investigation methods
+- **Cozy Mystery**: Lighter, often amateur detective
+
+### Hybrid Combinations
+
+- **Mystery + Thriller**: Suspense with puzzle-solving (Gone Girl, The Girl with the Dragon Tattoo)
+- **Mystery + Horror**: Supernatural or slasher mystery (The Wicker Man, Scream)
+- **Mystery + Comedy**: Light-hearted whodunit (Clue, Murder Mystery)
+- **Mystery + Sci-Fi**: Futuristic or speculative mystery (Minority Report, Blade Runner)
+
+## Best Practices
+
+1. **Plant Clues Early**: Foreshadow solution without telegraphing it
+2. **Fair Play**: Audience should be able to solve it with careful attention
+3. **Red Herrings**: Misdirect but don't mislead
+4. **Active Detective**: Protagonist drives investigation through intelligence
+5. **Escalate Stakes**: Increase danger and urgency as truth approaches
+6. **Satisfying Reveal**: Surprising yet inevitable solution
+7. **Clear Explanation**: Ensure audience understands solution without over-explaining
+8. **Rewatch Value**: Solution should recontextualize earlier scenes
+9. **Character Depth**: Mystery serves character development, not just plot
+10. **Respect Intelligence**: Trust audience to follow complex plotting
+
+## Resources
+
+- "Writing the Mystery" by G. Miki Hayden
+- "How to Write a Mystery" edited by Lee Child - Essays from mystery authors
+- "Chinatown" screenplay by Robert Towne - Masterclass in noir mystery
+- "The Big Sleep" by Raymond Chandler - Classic detective novel structure
+- "And Then There Were None" by Agatha Christie - Perfect closed-circle mystery
+
+---
+
+**Depth Coverage**: 85%
+**Last Updated**: 2026-01-31
+**Version**: 1.0.0
+