Contradiction Map

---
name: contradiction-map
description: >
  Use this skill when the user wants to find where sources, viewpoints, or perspectives disagree
  — phrases like "contradiction map", "where do these disagree", "map the conflicts", "find the
  disagreements", "where do the experts clash", "compare these viewpoints", "what do they agree
  on", or "find the gaps nobody covered". Works on an existing STORM workspace
  (.storm/{slug}/), on a set of files/documents, or on viewpoints pasted into the conversation.
  Spawns the contradiction-mapper agent. This is STORM Phase 2 standalone.
version: 1.0.0
user-invocable: true
---

# Contradiction Map — Find Where Understanding Lives

The most valuable understanding lives where credible sources **disagree**. Consensus is
comfortable; contradiction is where the real questions are — and the angle nobody covered is
often the gap in the entire field. This skill maps disagreement, agreement, and blind spots
across any set of viewpoints. It's STORM Phase 2, usable on its own.

## When to Use vs. `storm-research`

Use this directly when you **already have** the viewpoints to compare:
- A prior `multi-perspective-scan` left a workspace at `.storm/{slug}/`
- The user has several documents, reports, or articles to reconcile
- The user pastes a handful of competing positions and wants them mapped

For generating the perspectives first, then mapping them, use `multi-perspective-scan` or the
full `storm-research`.

## Workflow

### Step 1 — Locate the Inputs

Determine what's being compared:
- **STORM workspace:** if `.storm/{slug}/` exists with perspective files, use those.
- **Files/documents:** the user names paths or a directory — gather the relevant files.
- **Pasted viewpoints:** the positions are in the conversation — you'll pass them to the agent
  directly in the prompt.

If the source is unclear, ask one question to pin it down. Establish (or derive) a topic label
and, for file-based runs, a workspace `.storm/{slug}/` for the output (`mkdir -p` it).

### Step 2 — Spawn the Contradiction Mapper

Launch the **contradiction-mapper** agent with one **Task** call:

> "Topic: **{topic}**. Workspace: `.storm/{slug}/`. Inputs: {list of files, OR the pasted
> viewpoints inline}. Read every input in full and write `.storm/{slug}/contradiction-map.md`
> per your output contract — major contradictions with verdicts, the reliable core of
> agreement, and the blind spots none of the inputs addressed."

For purely pasted viewpoints with no workspace, instruct the agent to return the map inline
instead of writing a file.

### Step 3 — Present the Map

Surface the highlights and point to the full artifact:

```
Contradiction Map — {topic}
============================
Top contradictions
  1. {dispute} — verdict: {stronger side / unresolved}
  2. {…}

Reliable core (independent lenses converge)
  • {insight}

⚠ Blind spots (addressed by none)
  • {missing angle — why it matters}

Full map: .storm/{slug}/contradiction-map.md
```

Then offer to continue to synthesis (a briefing) via `storm-research`, or to investigate a
specific contradiction further.

## Notes

- **Blind spots are the high-value output.** A question none of the sources raised may be a gap
  in the whole field, not just in this set — flag those prominently.
- **Verdicts, not just a catalog.** The map judges each contradiction (or declares it unresolved
  and says what would settle it). A bare list of differences is half the job.