---
name: shuangdian-next
description: Get AI-guided suggestions for the next narrative satisfaction moment (爽点) with pattern recommendations and channel bonuses
---

# Shuangdian Next Skill

Use this skill when the user wants AI guidance on crafting the next satisfying narrative moment (爽点).

## What This Skill Does

1. **Analyzes Current State** - Examines recent chapters for patterns and channel fatigue
2. **Recommends Patterns** - Suggests specific patterns with bonus opportunities
3. **Provides Scaffolds** - Offers structural templates for chosen patterns
4. **Generates Examples** - Shows how the pattern could work in context
5. **Tracks Effectiveness** - Calculates expected reader satisfaction multipliers

## When to Use

- **After writing a few chapters** - "What pattern should I use next?"
- **Feeling stuck** - "I need a satisfying moment but don't know which type"
- **Optimizing engagement** - "How can I maximize reader satisfaction?"
- **Avoiding fatigue** - "Which patterns are getting overused?"

## Workflow

### Step 1: Gather Context
```
Reading current manuscript...
Analyzing last 3 chapters...
Checking pattern history...
Calculating channel fatigue...
```

### Step 2: Call MCP Analysis
```typescript
{
  name: 'analyze_shuangdian',
  arguments: {
    text: recentChapters,
    includeRecommendations: true
  }
}
```

### Step 3: Present Recommendations

Displays top 3 patterns ranked by:
- **Expected Strength** - Base intensity × bonuses
- **Channel Switch Bonus** - +50% if switching neural channels
- **Quadrant Shift Bonus** - +30% if shifting quadrants
- **Novelty Score** - How fresh the pattern is

### Step 4: User Selects Pattern

User picks one of:
1. **Insert Template** - Get structural scaffold
2. **See Example** - View detailed example
3. **Generate Scene** - AI writes the scene
4. **Explain Pattern** - Learn how it works

## Example Output

```markdown
## 🎯 Next Shuangdian Recommendations

Based on your last 3 chapters, here are the top patterns:

---

### 🥇 #1: Reversal - Underdog Reversal (REV-02)
**Expected Strength**: 1.8× (High Impact)

**Why this works**:
- ✅ **Channel Switch Bonus +50%**: Shifts from Dopamine → Adrenaline → Oxytocin
- ✅ **Quadrant Shift +30%**: Moves from Chaos Zone → Power Zone
- ✅ **High Novelty**: Pattern unused in last 5 chapters
- Current fatigue: Dopamine 68% → Adrenaline 22% (fresh!)

**What happens**:
The underestimated character reveals hidden preparation and turns the tables

**Scaffold**:
```
[Initial Setup]
- Protagonist appears outmatched
- Antagonist grows confident, underestimates threat
- Stakes are raised (time limit, audience, irreversible consequence)

[The Reversal]
- Small hint that something is off (antagonist's unease)
- Reveal: Protagonist was prepared all along
- Hidden preparation pays off (secret training, planted evidence, ally)
- Power dynamic flips completely

[Payoff]
- Antagonist's shock and forced acknowledgment
- Audience reaction (if present)
- Protagonist's calm confidence ("I knew you'd underestimate me")
```

**Example in your story**:
Your character Emma has been preparing in secret (Chapter 4 hints).
In the next scene, when the board meeting happens:
- The investors think she's unprepared
- She reveals the partnership she secured
- Their expressions change from pity to respect
- "Did you really think I'd come here empty-handed?"

---

### 🥈 #2: Revelation - Identity Reveal (RVL-02)
**Expected Strength**: 1.5× (Solid Impact)

**Why this works**:
- ✅ **Quadrant Shift +30%**: Chaos → Power
- ⚠️ **No Channel Switch**: Stays in Dopamine (already 68% fatigued)
- ✅ **Medium Novelty**: Used 3 chapters ago

**What happens**:
A hidden identity is revealed, changing power dynamics

**Scaffold**:
```
[Setup]
- Character has been hiding true identity/status
- Situation forces them to reveal it
- Stakes high enough to justify the reveal

[The Reveal]
- Trigger event (threat to someone, direct challenge, no other option)
- The reveal moment (visual change, statement, demonstration)
- Others' reactions (shock, disbelief, realization)
- Immediate consequences

[Payoff]
- Power shift is undeniable
- Past events recontextualized ("That's why they...")
- New respect or fear from others
```

---

### 🥉 #3: Mastery - Simple Solution (MAS-01)
**Expected Strength**: 1.3× (Good Impact)

**Why this works**:
- ✅ **Channel Switch +50%**: Dopamine → Serotonin (confidence)
- ⚠️ **No Quadrant Shift**: Stays in Power Zone
- ⚠️ **Lower Novelty**: Used 2 chapters ago

**What happens**:
Protagonist solves a complex problem with elegant simplicity

**Scaffold**:
```
[Setup]
- Complex problem has everyone confused
- Experts propose complicated solutions
- Protagonist observes quietly

[The Solution]
- Protagonist proposes simple approach
- Others are skeptical ("It can't be that easy")
- Demonstration proves it works
- Everyone realizes they overcomplicated it

[Payoff]
- Admiration for clarity of thought
- "Why didn't we think of that?"
- Protagonist's reputation for insight grows
```

---

## Select an option:
1. 📝 Insert scaffold for REV-02
2. 👁️ See detailed example for REV-02
3. ✍️ Generate scene using REV-02
4. 📚 Explain more about reversal patterns
5. 🔄 Show me different recommendations
```

## Advanced Features

### Pattern Chaining
Suggests sequences that work well together:
```
Reversal → Revelation → Closure
(Setup → Payoff → Resolution)
```

### Fatigue Warnings
```
⚠️ Warning: Dopamine channel at 68% fatigue
Consider switching to:
- Oxytocin (connection) - 15% fatigue
- Vagal (calm) - 5% fatigue
```

### Context-Aware Suggestions
Takes into account:
- Current plot phase (setup vs climax)
- Character arcs (where they are in development)
- Genre expectations (romance needs oxytocin, thriller needs adrenaline)
- Recent patterns (avoid repetition)

## MCP Integration

Calls two MCP tools:

1. **analyze_shuangdian** - Get current state
```typescript
{
  text: recentChapters,
  includeRecommendations: true
}
```

2. **get_pattern_template** - Retrieve scaffold (Phase 3 feature)
```typescript
{
  pattern: 'REV-02',
  context: storyContext
}
```

## User Actions

### 1. Insert Template
Inserts markdown scaffold at cursor:
```markdown
## Scene: [Name]

[Initial Setup]
- Protagonist appears outmatched
- ...

[The Reversal]
- Small hint that something is off
- ...
```

### 2. Generate Scene
Calls Claude Code to write full scene:
```
Using pattern REV-02 (Underdog Reversal):
[AI-generated 500-800 word scene]
```

### 3. Explain Pattern
Shows detailed breakdown:
- Archetype category
- Neural channel mapping
- Coordinate position
- Historical examples from literature
- Common pitfalls

## Tips for Users

1. **Trust the bonuses** - Channel switch and quadrant shift multiply impact
2. **Rotate patterns** - Don't use same pattern twice in a row
3. **Watch fatigue** - Red channels (>70%) need rest
4. **Match plot phase** - Use crisis patterns for climax, healing for resolution
5. **Chain strategically** - Setup patterns → Payoff patterns → Resolution patterns

## Related Skills

- `/shuangdian-analyze` - Analyze existing text for patterns
- `/plot-next` - Get general plot suggestions (uses Shuangdian internally)
- `/consistency-check` - Ensure pattern fits story logic

---

**Skill Status**: ✅ Ready for use (requires MCP server + Phase 3 templates)
**Dependencies**: MCP `analyze_shuangdian` tool, pattern templates (shuangdian_templates.ts)