Theory & Model Construction (psychrev-theory-construction)
When to trigger
- The problem and the rivals are set; now you must build the theory
- You have intuitions but no explicit assumptions or mechanism
- Your "model" is a diagram with no specified dynamics or equations
- Verbal claims need to be made formal enough to derive predictions
The build order
A Psychological Review theory is assembled in a disciplined sequence. Skipping a step is the
most common reason a draft reads as "a story, not a theory."
- State the assumptions (primitives). What entities, representations, and processes does
the theory posit, and what is taken as given? Separate core commitments (the theory
lives or dies by these) from auxiliary/implementational assumptions (convenient,
replaceable). Reviewers attack hidden or load-bearing-but-unstated assumptions hardest.
- Specify the mechanism — the why. The mechanism is the engine: the causal/dynamic
story by which the primitives produce the phenomena. A model without a mechanism is a
curve-fit. State it in prose before you formalize it.
- Formalize. Render the mechanism as math, a computational process, or a precise
conceptual structure. For a formal/computational model: give the equations or
algorithm, define every parameter (psychological meaning, range, units), and state the
functional forms and why those forms. A free parameter with no interpretation is a liability.
- Derive the model's behavior. Show what the model does: closed-form results where
possible, otherwise simulation. The behavior, not the equations alone, is the theory's
content. (Confront that behavior with data in
psychrev-argument-development.)
- Connect to the explanandum. Map each posited mechanism to the phenomena it is meant to
explain — and flag phenomena it leaves to other processes.
- Distinguish theory from implementation. Be explicit about which results follow from the
core commitments versus from implementational choices, so a reviewer cannot dismiss the
theory by attacking a replaceable detail.
Formal-model discipline (for computational/mathematical theories)
- Every parameter has a psychological interpretation, not just a fitted value.
- State functional forms and justify them theoretically, not by fit alone.
- Distinguish structural assumptions (architecture) from parametric ones (settings).
- If the model is fit to data, say so plainly and treat fit as illustration/constraint, not
as the empirical contribution — the contribution is the theory.
- Plan for
psychrev-boundary-conditions: note where identifiability or scope may be at risk.
Conceptual-model discipline (for non-formal frameworks)
- Each construct: a precise definition, what it includes and excludes, and how it differs
from the nearest existing construct (no relabels).
- Each relationship: named form (causal, recursive, constitutive, inhibitory) and a mechanism.
- The framework must yield derivable predictions, even if stated verbally — generality
without testable consequences is not a Review contribution.
Checklist
Anti-patterns
- A model that is a redescription of the data with enough free parameters to fit anything
- Parameters introduced with no psychological meaning ("a scaling constant" doing real work)
- Listing equations without ever showing what the model does
- Hidden core assumptions exposed later by a reviewer
- A "framework" of boxes and arrows with no mechanism and no derivable prediction
- Smuggling in a new experiment as the contribution — data only motivate or constrain here
Output format
【Assumptions】core commitments | auxiliary/implementational
【Mechanism】[the why, in prose]
【Formal structure】equations / algorithm / conceptual structure; parameters with meaning + range
【Model behavior】[derived results: closed-form or simulation summary]
【Explanandum map】mechanism → phenomena explained (and phenomena left to others)
【Next step】psychrev-argument-development (derive predictions, confront data + rivals)
Source: brycewang-stanford/Awesome-Journal-Skills → Psychological-Review-Skills/skills/psychrev-theory-construction/SKILL.md
1---2name: psychrev-theory-construction3description: Use when building the actual theory or formal/computational model for a Psychological Review manuscript — turning a framed problem into explicit assumptions, mechanisms, formal structure, and derivations. Constructs the model; it does NOT derive and test predictions against data (that is psychrev-argument-development) or set scope and identifiability limits (psychrev-boundary-conditions).4---567# Theory & Model Construction (psychrev-theory-construction)89## When to trigger1011- The problem and the rivals are set; now you must build the theory12- You have intuitions but no explicit assumptions or mechanism13- Your "model" is a diagram with no specified dynamics or equations14- Verbal claims need to be made formal enough to derive predictions1516## The build order1718A Psychological Review theory is assembled in a disciplined sequence. Skipping a step is the19most common reason a draft reads as "a story, not a theory."20211. **State the assumptions (primitives).** What entities, representations, and processes does22 the theory posit, and what is taken as given? Separate **core commitments** (the theory23 lives or dies by these) from **auxiliary/implementational assumptions** (convenient,24 replaceable). Reviewers attack hidden or load-bearing-but-unstated assumptions hardest.252. **Specify the mechanism — the *why*.** The mechanism is the engine: the causal/dynamic26 story by which the primitives produce the phenomena. A model without a mechanism is a27 curve-fit. State it in prose before you formalize it.283. **Formalize.** Render the mechanism as math, a computational process, or a precise29 conceptual structure. For a **formal/computational model**: give the equations or30 algorithm, define every **parameter** (psychological meaning, range, units), and state the31 functional forms and why those forms. A free parameter with no interpretation is a liability.324. **Derive the model's behavior.** Show what the model *does*: closed-form results where33 possible, otherwise simulation. The behavior, not the equations alone, is the theory's34 content. (Confront that behavior with data in `psychrev-argument-development`.)355. **Connect to the explanandum.** Map each posited mechanism to the phenomena it is meant to36 explain — and flag phenomena it leaves to other processes.376. **Distinguish theory from implementation.** Be explicit about which results follow from the38 core commitments versus from implementational choices, so a reviewer cannot dismiss the39 theory by attacking a replaceable detail.4041## Formal-model discipline (for computational/mathematical theories)4243- Every parameter has a **psychological interpretation**, not just a fitted value.44- State **functional forms** and justify them theoretically, not by fit alone.45- Distinguish **structural** assumptions (architecture) from **parametric** ones (settings).46- If the model is fit to data, say so plainly and treat fit as *illustration/constraint*, not47 as the empirical contribution — the contribution is the theory.48- Plan for `psychrev-boundary-conditions`: note where identifiability or scope may be at risk.4950## Conceptual-model discipline (for non-formal frameworks)5152- Each construct: a precise definition, what it includes and excludes, and how it differs53 from the nearest existing construct (no relabels).54- Each relationship: named form (causal, recursive, constitutive, inhibitory) and a mechanism.55- The framework must yield **derivable predictions**, even if stated verbally — generality56 without testable consequences is not a Review contribution.5758## Checklist5960- [ ] Core commitments separated from auxiliary/implementational assumptions61- [ ] The mechanism (the why) is stated in prose before formalization62- [ ] Every parameter / construct has a psychological interpretation and stated range or domain63- [ ] Functional forms / relationship forms are justified theoretically64- [ ] The model's behavior is derived (closed-form or simulated), not just its equations listed65- [ ] Each mechanism is mapped to the phenomena it explains66- [ ] Theory-level results are distinguished from implementation-level choices6768## Anti-patterns6970- A model that is a redescription of the data with enough free parameters to fit anything71- Parameters introduced with no psychological meaning ("a scaling constant" doing real work)72- Listing equations without ever showing what the model *does*73- Hidden core assumptions exposed later by a reviewer74- A "framework" of boxes and arrows with no mechanism and no derivable prediction75- Smuggling in a new experiment as the contribution — data only motivate or constrain here7677## Output format7879```80【Assumptions】core commitments | auxiliary/implementational81【Mechanism】[the why, in prose]82【Formal structure】equations / algorithm / conceptual structure; parameters with meaning + range83【Model behavior】[derived results: closed-form or simulation summary]84【Explanandum map】mechanism → phenomena explained (and phenomena left to others)85【Next step】psychrev-argument-development (derive predictions, confront data + rivals)86```8788---8990**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `Psychological-Review-Skills/skills/psychrev-theory-construction/SKILL.md`