Jel Comprehensiveness And Balance

Comprehensiveness & Balance (jel-comprehensiveness-and-balance)

When to trigger

• The framework is set and you are filling cells with the literature
• You are unsure whether to cite everything or curate
• The field has rival schools, a live controversy, or conflicting empirical results
• You are a contributor to this literature and worry the survey tilts toward your own work

Completeness vs. selectivity: the JEL contract

A JEL survey must be comprehensive in coverage yet selective in emphasis. The reader should trust that nothing important is missing, while the prose foregrounds what matters. Resolve the tension by tiering the corpus:

Comprehensiveness is proven by the citation set (the saturation log from jel-literature-synthesis); selectivity is exercised in the prose. A survey that discusses every paper at equal length has abdicated the editorial judgment that is its value.

Fairness across schools, authors, and findings

JEL is the survey of record: its account of a debate becomes the field's shared reference. That obliges genuine even-handedness:

• Steelman every camp. State each school's strongest case in terms its proponents would accept before noting its weaknesses. Refute positions at their best, never at their worst.
• Weigh, don't tally. Conflicting results are reconciled by credibility (identification, data, replication) and by what each estimates, not by vote-counting "7 studies find positive, 4 negative."
• Attribute ideas correctly. Credit originators, not just popularizers; this is a recurring referee complaint.
• Handle live controversies without resolving by fiat. Lay out the disagreement, what evidence would settle it, and where the author's own read sits — labelled as the author's read, not as consensus.

The self-citation trap

If you have published in the field, the survey must not read as a retrospective of your program. Guardrails:

• Your own work is cited at the tier its importance to the field warrants — no more.
• Rivals to your work are given their strongest statement.
• A reader who does not know who wrote the survey cannot tell from the emphasis.
• When the field disagrees with you, say so plainly and represent the other side fairly.

Checklist

• Corpus tiered (foundational / important / confirmatory / tangential); prose emphasis matches tier
• Comprehensiveness provable from the citation set + saturation log
• Every rival school stated at its strongest before critique (steelman)
• Conflicting findings reconciled by credibility and estimand, not vote-counting
• Idea attribution traces to originators
• Live controversies presented with what evidence would settle them; author's read labelled as such
• Self-citation audited: own work at field-warranted tier; rivals steelmanned; emphasis is identity-blind
• No important author/school an informed referee could say was slighted or omitted

Anti-patterns

• Comprehensiveness theatre: equal-length summaries of every paper (no editorial judgment)
• Vote-counting conflicting results instead of weighing credibility and estimand
• Strawmanning the camp the author disagrees with
• A survey that doubles as the author's CV (the most-punished JEL balance failure)
• Declaring a live controversy "resolved" by assertion rather than by laying out the evidentiary state
• Crediting the popularizer of an idea over its originator

Output format

【Tiering】corpus split foundational/important/confirmatory/tangential? Y/N
【Comprehensiveness evidence】saturation log + citation set support "nothing important missing"? Y/N
【Steelman】each rival school stated at its strongest? Y/N
【Conflict handling】reconciled by credibility + estimand (not vote-count)? Y/N
【Controversy】evidence-to-settle stated; author's read labelled? Y/N
【Self-citation audit】own work at warranted tier; emphasis identity-blind? Y/N
【Next step】→ jel-tables-figures (who-found-what tables) → jel-writing-style

Source: brycewang-stanford/Awesome-Journal-Skills → Journal-of-Economic-Literature-Skills/skills/jel-comprehensiveness-and-balance/SKILL.md