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
- Concept — define the key IR construct precisely (e.g., institutional legitimacy, audience cost,
credible commitment); distinguish it from neighbors.
- International mechanism — the causal story at/across the international level: which actors
(states, IGOs, firms, transnational groups), what strategic incentives and constraints, why.
- 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.
- 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
Source: brycewang-stanford/Awesome-Journal-Skills → International-Organization-Skills/skills/io-theory-building/SKILL.md
1---2name: io-theory-building3description: 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.4---567# Theory & Argument Building (io-theory-building)89IO publishes "articles that propose **generalizable theories**" of international politics. A result is10not an IO contribution until it is attached to an **IR theory the field can carry to other cases,11dyads, and institutions.** This skill turns findings into theory: explicit mechanisms operating at or12across the international level, scope conditions, and observable implications.1314## When to trigger1516- The empirics are strong but the "so what for IR theory" is thin17- A reviewer said the paper is "atheoretical," "ad hoc," or "just a finding"18- You need to state the international mechanism, assumptions, and scope conditions explicitly19- Formal modeling: deciding what to model about strategic interaction among states/actors2021## Build the argument (by mode of work)2223### Empirical paper with an IR theory241. **Concept** — define the key IR construct precisely (e.g., institutional legitimacy, audience cost,25 credible commitment); distinguish it from neighbors.262. **International mechanism** — the causal story at/across the international level: which actors27 (states, IGOs, firms, transnational groups), what strategic incentives and constraints, why.283. **Observable implications** — what we should see if the mechanism operates internationally (and what29 we should *not* see). These become the tests in `io-research-design`.304. **Scope conditions** — which regimes, issue areas, or structural conditions the argument holds under.31 Portability ≠ universality.3233### Formal / game-theoretic paper (a core IO mode)34- State the **substantive IR puzzle** (bargaining failure, cooperation under anarchy, delegation,35 signaling) before the setup.36- Keep assumptions **transparent and motivated**; flag which equilibria are robust to which assumptions.37- Translate equilibrium predictions into **comparative statics** a reader can test or recognize in38 international politics.39- Note: IO **verifies proofs of formal models before final acceptance** — write proofs to be checked40 (complete, in an appendix), not gestured at.4142### Constructivist / ideational / interpretive paper43- Make the **conceptual stakes** explicit — norms, identities, legitimacy, social meaning in world44 politics — and connect them to behavior.45- Build the argument through reasons, discourse, and evidence; engage the **rationalist baseline** it46 improves on and state what each would and would not expect to observe.4748## The "portability" test (IO-specific)4950Ask: *Could an IR scholar import this mechanism to a different issue area, dyad, or institution?* If51yes, you have a generalizable IR theory. If it only works for your one case/IGO, generalize the logic52or reframe (back to `io-topic-selection`).5354## Worked theory vignette (illustrative): finding to portable theory5556Start with a bare finding: states joining an international monitoring institution show higher later57compliance. As stated it is not yet an IO contribution — it could be selection and names no general58mechanism. To build it into a theory: define the **construct** (*credible commitment via delegated59monitoring*); state the **cross-border mechanism** — monitoring makes violations common knowledge across60the membership, so states anticipating future cooperation gains internalize the reputational cost, a logic61running through the institution, not any domestic process;62derive **observable implications** (gains concentrate where monitoring is informative, *absent* where63conduct is unobservable); bound it with **scope conditions** (verifiable conduct, repeated interaction);64and check **portability** — the logic travels to arms control, trade dispute settlement, or environmental65regimes, clearing IO's broad-significance bar.6667## Theory-strength rubric (how an IO referee grades the argument)6869| Grade | Argument looks like… | Typical referee line |70|-------|----------------------|----------------------|71| Strong | portable mechanism + scope conditions + clear non-implications | "a generalizable theory of world politics" |72| Borderline | a mechanism named but tied to one institution | "promising but narrow — does it travel?" |73| Weak | a finding with hypotheses attached post hoc | "atheoretical / ad hoc" |7475IO's theory premium means a Borderline argument with flawless empirics still often draws an R&R aimed at76the theory, not the data.7778## Anti-patterns7980- A domestic-politics mechanism relabeled as IR — the action must be international or cross-border81- "Hypothesizing after results are known" (HARKing); preregister where possible82- A formal model with opaque assumptions tuned to the desired equilibrium, or proofs left incomplete83- Mechanisms named but never made observable at the international level84- Universal claims with no scope conditions; a finding with no theory the field can reuse85- A mechanism that travels nowhere beyond the studied institution (fails the broad-significance bar)8687## Output format8889```90【Core IR claim】one sentence91【International mechanism】the causal/strategic story (who, why, under what constraints)92【Assumptions】(formal) the load-bearing ones; proof appendix planned?93【Observable implications】testable consequences → research-design94【Scope conditions】issue areas / regimes where it holds / fails95【Portability】who else in IR can use this theory96【Next】io-research-design97```9899## Supplementary resources100101- [`../../resources/external_tools.md`](../../resources/external_tools.md) — formal-modeling and analysis tooling102- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — IO generalizable-theory scope; formal-proof verification103104---105106**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `International-Organization-Skills/skills/io-theory-building/SKILL.md`