---
name: thread
description: Retrofit narrative threads (callbacks, foreshadowing, motifs) across multiple episodes.
allowed-tools: Read, Write, Edit, Glob
argument-hint: "\"[thread_name]\" --episodes [N,N,N]"
---

# /thread - Plant/Payoff Threading

Retrofit narrative threads across multiple episodes — seeding callbacks, foreshadowing, and recurring motifs.

## Usage

```
/thread [project] "[thread_name]" --episodes [N,N,N,N]
/thread [project] "[thread_name]" --auto
```

**Examples:**
```
/thread leviathan "Lucky Coin" --episodes 1,15,35,56
/thread leviathan "Kian's memory of Earth" --auto
/thread leviathan "Jinx's debt number" --episodes 3,22,45,60
```

## Parameters

| Parameter | Required | Default | Description |
|-----------|----------|---------|-------------|
| `project` | Yes | — | Project folder name |
| `"[thread_name]"` | Yes | — | Name/description of the thread |
| `--episodes [N,N,N,N]` | No | — | Specific episodes for thread touchpoints |
| `--auto` | No | false | AI suggests optimal episode placements |

## Thread Types

| Type | Pattern | Example |
|------|---------|---------|
| **Object Callback** | Physical item that recurs | Lucky coin, photograph, weapon |
| **Phrase Echo** | Line that gains meaning through repetition | "Good luck, partner" |
| **Memory Thread** | Flashback/reference that deepens | Character's past revealed in layers |
| **Foreshadow/Payoff** | Setup that pays off later | Chekhov's gun, rule establishment |
| **Relationship Marker** | Milestone in character dynamic | First name use, sacrifice callback |

## What It Does

1. Analyzes series for optimal thread placement (if `--auto`)
2. Proposes surgical insertions at specific moments
3. Respects existing content and V12 constraints
4. Tracks threads in `plant_payoff_plan.md`

## Execution

When this skill is invoked:

1. **Read the agent prompt:** `/agents/thread_agent.md`
2. **Read target episodes** from `/[project]/scripting/episodes/`
3. **Propose insertions interactively** for user approval
4. **Update plant_payoff tracking** after insertions