ppsych-organizing-framework
GitHub为心理学综合综述构建核心分析框架，将文献转化为统一论点。适用于证据矩阵已建但缺乏逻辑主线、章节命名仅基于主题或无法概括核心主张的场景，旨在通过分类、理论或重构赋予研究结构，避免沦为注释性书目。
Trigger Scenarios
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill ppsych-organizing-framework -g -y
SKILL.md
Frontmatter
{
"name": "ppsych-organizing-framework",
"description": "Use when imposing an analytical or conceptual structure on a body of psychology research for a Perspectives on Psychological Science (PoPS) integrative review or theoretical statement — the unifying argument or \"spine\" that turns a reading list into a claim about the field. Designs the framework; it does not gather the literature (ppsych-literature-synthesis) or audit balance (ppsych-comprehensiveness-and-balance)."
}
Organizing Framework — the Argument's Spine (ppsych-organizing-framework)
When to trigger
- The evidence matrix is built but the draft would read like a list of papers
- Sections are named after topics ("Behavioral studies", "Neuro work") rather than ideas
- A reader could not predict what comes next or why papers are grouped as they are
- You cannot state in one sentence the argument or unifying claim the piece makes about the field
Why the spine is the whole game at PoPS
The most-cited reason integrative reviews fail is that they are annotated bibliographies — paper-after-paper summaries with no organizing idea. A great PoPS piece imposes a structure the field did not have: a taxonomy, a unifying theory, a sequence of questions, or a reframing that makes scattered cross-area work legible and provocative. The framework is the contribution; the citations are the evidence. PoPS's breadth mandate raises the bar: the spine must be graspable by a psychologist from a different area on one read, and it should reframe, not merely organize. Choose it deliberately:
| Spine type | Organizes the field by | Best when |
|---|---|---|
| Taxonomy | mutually-exclusive categories of mechanism/phenomenon | the field is fragmented into incommensurable camps |
| Unifying theory/model | a framework whose constructs index the studies | results disagree because they tap different parts of one structure |
| Question sequence | a logical chain of sub-questions | the field has a natural "first establish X, then Y" order |
| Paradigm/historical | how thinking evolved and why | the evolution of ideas is itself the lesson |
| Reframe / inversion | overturning a default assumption the field holds | the contribution is a provocation ("the field has it backwards") |
| Meta-science map | practices vs. outcomes (e.g., power × replicability) | the piece is about how the field works, not what it finds |
Pick one primary spine; a second axis can order papers within a section, but a piece with two competing spines reads as two papers.
The test of a good framework
- Exhaustive + exclusive (MECE-ish): every important paper has exactly one natural home, and categories do not bleed.
- Generative: the framework predicts gaps — empty cells are open questions, not omissions (PoPS prizes the forward agenda).
- Reconciling: apparent contradictions become explained (studies disagree because they sit in different cells / tap different constructs).
- Portable + provocative: a psychologist from another area can restate the spine after one read and feels the reframing is worth arguing about.
Stress-test by placing 5 hard cases (papers that resist categorization). If three have no home, the spine is wrong — redesign before drafting.
The spine is also what lets a PoPS piece be selective without being incomplete: once each cell is defined, confirmatory studies can be cited in clusters within their cell while the prose carries only the cell-defining work and the argument. This is how you honor cross-area coverage while staying concise. Design the spine before deciding what to foreground.
For theoretical statements specifically
When the contribution is the theory (not a review of one), the framework section is the paper. Make the constructs and their relations explicit; state the assumptions; derive what the theory predicts that rival accounts do not; and specify what evidence would falsify it. A theoretical statement that cannot be wrong is not a contribution — name the discriminating tests.
Checklist
- One primary spine chosen (taxonomy / theory / question-sequence / paradigm / reframe / meta-science map)
- The piece's one-sentence argument about the field is written
- Every category traces to evidence-matrix rows (no empty rhetorical buckets)
- The framework reconciles at least one apparent contradiction across areas
- Empty cells surfaced as open questions (generativity — the future agenda)
- 5 hard-case papers each have a natural home
- Section headings name ideas/mechanisms, not "theory vs. empirical"
- A psychologist from another area could restate the spine and slot a new paper into it
- (Theoretical statement) assumptions, novel predictions, and falsifying evidence are explicit
Anti-patterns
- The annotated bibliography: paper-by-paper summaries with no organizing idea (the cardinal review sin)
- Sections named "Theory", "Evidence", "Other" — categories with no analytical content
- A taxonomy whose categories overlap so every paper is cited three times in three places
- Two competing spines fighting for control of the same piece
- A framework so bespoke only the author can apply it (fails PoPS's cross-area test)
- Hiding the contribution: never stating, in one sentence, what the piece argues about the field
- A theoretical statement that makes no falsifiable, discriminating prediction
Output format
【Spine type】taxonomy / unifying-theory / question-sequence / paradigm / reframe / meta-science-map
【Argument about the field】"<one sentence the piece makes>"
【Categories】<the cells / sub-questions, each MECE>
【Reconciliation】<which cross-area contradiction the framework explains>
【Open questions】<empty cells surfaced as the future agenda>
【Hard-case test】5 awkward papers each placed? Y/N
【Portability + provocation】another-area psychologist can restate it; worth arguing about? Y/N
【Theory (if applicable)】assumptions + novel predictions + falsifiers explicit? Y/N · N/A
【Next step】→ ppsych-comprehensiveness-and-balance (fill cells fairly; audit coverage + balance)
Version History
- 1839142 Current 2026-07-05 14:11
