Theory & Argument Building (ajps-theory-building)
At AJPS the theory exists to generate testable expectations that the design and data then
adjudicate. The journal's empirical bar means a model or argument earns its place only if it yields
observable, falsifiable implications that the analysis can confront. This skill turns an idea into
hypotheses, mechanisms, and scope conditions in the idiom your work demands.
When to trigger
- The empirics are strong but the "why" / mechanism is thin
- A reviewer said the paper is "atheoretical," "ad hoc," or "a model with no test"
- You need to state mechanisms, assumptions, and scope conditions explicitly
- Formal modeling: deciding what to model, what to assume, and what the model buys
Build the argument (by mode of work)
Empirical paper with a theory
- Concept — define key constructs precisely; distinguish from neighbors and from how they will be
measured (hand off to
ajps-data-analysis for validation).
- Mechanism — the causal story: who acts, why, under what incentives/constraints.
- Hypotheses — state the directional, testable expectations before the results, and what
pattern would disconfirm them. These become the tests in
ajps-research-design.
- Scope conditions — where the argument holds and where it does not.
Formal / game-theoretic paper
- State the substantive puzzle the model addresses before the setup.
- Keep assumptions transparent and motivated; flag which results depend on which assumptions.
- Translate equilibrium predictions into comparative statics a reader can test or recognize.
- Make the empirical test follow from the model, and distinguish predictions unique to your model
from those shared with rivals.
Measurement / methodology paper (Research Note territory)
- Define the quantity the new measure/method recovers and the bias in existing approaches.
- State the conditions under which it outperforms incumbents, with a validation plan.
The "testability" gate (AJPS-specific)
Before proceeding, write the sentence: "If the theory is right, we should observe ___; if a rival is
right, we should observe ___ instead." If you cannot fill both blanks with something the data can
distinguish, the theory is not yet ready for an AJPS empirical confrontation.
Anti-patterns
- HARKing — fitting hypotheses to results after the fact; state theory before tests, preregister where possible
- A model whose assumptions are reverse-engineered to deliver the desired prediction
- Mechanisms named but never made observable or testable
- Universal claims with no scope conditions
- Burying the argument under the empirics — the contribution must be stated plainly up front
Operating pass for American Journal of Political Science
Run this as a concrete capability pass. First lock the political theory, design leverage, measurement validity, and scope condition; then test whether the manuscript addresses political-science reviewers who expect tight theory, transparent design, and a contribution that travels across political settings.
- Primary move: Return a claim-evidence-risk ledger; every recommendation must point to a manuscript location or missing artifact.
- Decision ledger: return
claim / evidence / blocker / next edit rows so the next pass can patch the manuscript directly.
- Sibling comparison: compare against APSR for field-wide breadth, Journal of Politics for broader political-science audience, Political Analysis for methods-first work; if the neighboring outlet has the stronger audience claim, recommend re-routing before polishing.
- Verification floor: before submission-ready advice, re-open
resources/official-source-map.md for volatile rules and name the one unresolved fact that could change the recommendation.
Output format
【Core claim】one sentence
【Mechanism】the causal/logical story
【Hypotheses】directional, stated before results
【Assumptions】(formal) the load-bearing ones
【Disconfirming pattern】what would falsify it
【Scope conditions】where it holds / fails
【Next】ajps-research-design
Supplementary resources
Source: brycewang-stanford/Awesome-Journal-Skills → American-Journal-of-Political-Science-Skills/skills/ajps-theory-building/SKILL.md
1---2name: ajps-theory-building3description: Use when building the theoretical argument of an American Journal of Political Science (AJPS) manuscript — whether empirical with explicit mechanisms, formal/game-theoretic, or measurement-driven. AJPS rewards testable theory tightly linked to the empirical strategy, with hypotheses stated before the results. Structures the argument; it does not run analyses.4---567# Theory & Argument Building (ajps-theory-building)89At AJPS the theory exists to **generate testable expectations** that the design and data then10adjudicate. The journal's empirical bar means a model or argument earns its place only if it yields11**observable, falsifiable implications** that the analysis can confront. This skill turns an idea into12hypotheses, mechanisms, and scope conditions in the idiom your work demands.1314## When to trigger1516- The empirics are strong but the "why" / mechanism is thin17- A reviewer said the paper is "atheoretical," "ad hoc," or "a model with no test"18- You need to state mechanisms, assumptions, and scope conditions explicitly19- Formal modeling: deciding what to model, what to assume, and what the model buys2021## Build the argument (by mode of work)2223### Empirical paper with a theory241. **Concept** — define key constructs precisely; distinguish from neighbors and from how they will be25 measured (hand off to `ajps-data-analysis` for validation).262. **Mechanism** — the causal story: who acts, why, under what incentives/constraints.273. **Hypotheses** — state the **directional, testable** expectations *before* the results, and what28 pattern would **disconfirm** them. These become the tests in `ajps-research-design`.294. **Scope conditions** — where the argument holds and where it does not.3031### Formal / game-theoretic paper32- State the **substantive puzzle** the model addresses before the setup.33- Keep assumptions **transparent and motivated**; flag which results depend on which assumptions.34- Translate equilibrium predictions into **comparative statics** a reader can test or recognize.35- Make the empirical test follow from the model, and distinguish predictions **unique** to your model36 from those shared with rivals.3738### Measurement / methodology paper (Research Note territory)39- Define the quantity the new measure/method recovers and the bias in existing approaches.40- State the conditions under which it outperforms incumbents, with a validation plan.4142## The "testability" gate (AJPS-specific)4344Before proceeding, write the sentence: *"If the theory is right, we should observe ___; if a rival is45right, we should observe ___ instead."* If you cannot fill both blanks with something the data can46distinguish, the theory is not yet ready for an AJPS empirical confrontation.4748## Anti-patterns4950- HARKing — fitting hypotheses to results after the fact; state theory before tests, preregister where possible51- A model whose assumptions are reverse-engineered to deliver the desired prediction52- Mechanisms named but never made observable or testable53- Universal claims with no scope conditions54- Burying the argument under the empirics — the contribution must be stated plainly up front555657## Operating pass for American Journal of Political Science5859Run this as a concrete capability pass. First lock the political theory, design leverage, measurement validity, and scope condition; then test whether the manuscript addresses political-science reviewers who expect tight theory, transparent design, and a contribution that travels across political settings.6061- **Primary move:** Return a claim-evidence-risk ledger; every recommendation must point to a manuscript location or missing artifact.62- **Decision ledger:** return `claim / evidence / blocker / next edit` rows so the next pass can patch the manuscript directly.63- **Sibling comparison:** compare against APSR for field-wide breadth, Journal of Politics for broader political-science audience, Political Analysis for methods-first work; if the neighboring outlet has the stronger audience claim, recommend re-routing before polishing.64- **Verification floor:** before submission-ready advice, re-open `resources/official-source-map.md` for volatile rules and name the one unresolved fact that could change the recommendation.6566## Output format6768```69【Core claim】one sentence70【Mechanism】the causal/logical story71【Hypotheses】directional, stated before results72【Assumptions】(formal) the load-bearing ones73【Disconfirming pattern】what would falsify it74【Scope conditions】where it holds / fails75【Next】ajps-research-design76```7778## Supplementary resources7980- [`../../resources/external_tools.md`](../../resources/external_tools.md) — formal-modeling and analysis tooling81- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — AJPS scope and contribution expectations8283---8485**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `American-Journal-of-Political-Science-Skills/skills/ajps-theory-building/SKILL.md`