Io Theory Building

---
name: io-theory-building
description: "Use when building the theoretical argument of an International Organization (IO) manuscript into a generalizable theory of international politics — whether rationalist/formal (bargaining, signaling, delegation, cooperation), constructivist/ideational, or empirical with explicit international mechanisms. IO rewards a portable IR theory over a bare finding. Structures the argument; it does not run analyses."
category: ai-agents-and-harness
source_repo: brycewang-stanford/Awesome-Journal-Skills
source_path: "International-Organization-Skills/skills/io-theory-building/SKILL.md"
source_url: https://github.com/brycewang-stanford/Awesome-Journal-Skills/blob/HEAD/International-Organization-Skills/skills/io-theory-building/SKILL.md
---


# Theory & Argument Building (io-theory-building)

IO publishes "articles that propose **generalizable theories**" of international politics. A result is
not an IO contribution until it is attached to an **IR theory the field can carry to other cases,
dyads, and institutions.** This skill turns findings into theory: explicit mechanisms operating at or
across the international level, scope conditions, and observable implications.

## When to trigger

- The empirics are strong but the "so what for IR theory" is thin
- A reviewer said the paper is "atheoretical," "ad hoc," or "just a finding"
- You need to state the international mechanism, assumptions, and scope conditions explicitly
- Formal modeling: deciding what to model about strategic interaction among states/actors

## Build the argument (by mode of work)

### Empirical paper with an IR theory
1. **Concept** — define the key IR construct precisely (e.g., institutional legitimacy, audience cost,
   credible commitment); distinguish it from neighbors.
2. **International mechanism** — the causal story at/across the international level: which actors
   (states, IGOs, firms, transnational groups), what strategic incentives and constraints, why.
3. **Observable implications** — what we should see if the mechanism operates internationally (and what
   we should *not* see). These become the tests in `io-research-design`.
4. **Scope conditions** — which regimes, issue areas, or structural conditions the argument holds under.
   Portability ≠ universality.

### Formal / game-theoretic paper (a core IO mode)
- State the **substantive IR puzzle** (bargaining failure, cooperation under anarchy, delegation,
  signaling) before the setup.
- Keep assumptions **transparent and motivated**; flag which equilibria are robust to which assumptions.
- Translate equilibrium predictions into **comparative statics** a reader can test or recognize in
  international politics.
- Note: IO **verifies proofs of formal models before final acceptance** — write proofs to be checked
  (complete, in an appendix), not gestured at.

### Constructivist / ideational / interpretive paper
- Make the **conceptual stakes** explicit — norms, identities, legitimacy, social meaning in world
  politics — and connect them to behavior.
- Build the argument through reasons, discourse, and evidence; engage the **rationalist baseline** it
  improves on and state what each would and would not expect to observe.

## The "portability" test (IO-specific)

Ask: *Could an IR scholar import this mechanism to a different issue area, dyad, or institution?* If
yes, you have a generalizable IR theory. If it only works for your one case/IGO, generalize the logic
or reframe (back to `io-topic-selection`).

## Worked theory vignette (illustrative): finding to portable theory

Start with a bare finding: states joining an international monitoring institution show higher later
compliance. As stated it is not yet an IO contribution — it could be selection and names no general
mechanism. To build it into a theory: define the **construct** (*credible commitment via delegated
monitoring*); state the **cross-border mechanism** — monitoring makes violations common knowledge across
the membership, so states anticipating future cooperation gains internalize the reputational cost, a logic
running through the institution, not any domestic process;
derive **observable implications** (gains concentrate where monitoring is informative, *absent* where
conduct is unobservable); bound it with **scope conditions** (verifiable conduct, repeated interaction);
and check **portability** — the logic travels to arms control, trade dispute settlement, or environmental
regimes, clearing IO's broad-significance bar.

## Theory-strength rubric (how an IO referee grades the argument)

| Grade | Argument looks like… | Typical referee line |
|-------|----------------------|----------------------|
| Strong | portable mechanism + scope conditions + clear non-implications | "a generalizable theory of world politics" |
| Borderline | a mechanism named but tied to one institution | "promising but narrow — does it travel?" |
| Weak | a finding with hypotheses attached post hoc | "atheoretical / ad hoc" |

IO's theory premium means a Borderline argument with flawless empirics still often draws an R&R aimed at
the theory, not the data.

## Anti-patterns

- A domestic-politics mechanism relabeled as IR — the action must be international or cross-border
- "Hypothesizing after results are known" (HARKing); preregister where possible
- A formal model with opaque assumptions tuned to the desired equilibrium, or proofs left incomplete
- Mechanisms named but never made observable at the international level
- Universal claims with no scope conditions; a finding with no theory the field can reuse
- A mechanism that travels nowhere beyond the studied institution (fails the broad-significance bar)

## Output format

```
【Core IR claim】one sentence
【International mechanism】the causal/strategic story (who, why, under what constraints)
【Assumptions】(formal) the load-bearing ones; proof appendix planned?
【Observable implications】testable consequences → research-design
【Scope conditions】issue areas / regimes where it holds / fails
【Portability】who else in IR can use this theory
【Next】io-research-design
```

## Supplementary resources

- [`../../resources/external_tools.md`](../../resources/external_tools.md) — formal-modeling and analysis tooling
- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — IO generalizable-theory scope; formal-proof verification

---

**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `International-Organization-Skills/skills/io-theory-building/SKILL.md`