Paper Type Playbooks
This page gives standard example routes for the four canonical paper types:
systematic-reviewempiricalmethodstheory
These are not the only valid routes. They are the recommended defaults when you want a defensible baseline workflow.
How To Read These Examples
Each playbook includes:
- a recommended route
- a narrower route for lighter work
- key skills usually involved
- typical outputs
- a starter command
Use them as operating defaults, then narrow or deepen based on your actual constraints.
1. Systematic Review
Use this when
You are building a PRISMA-style review, evidence synthesis, or structured related-work base with transparent search and screening logic.
Recommended route
A1: clarify question and scopeB1: run reproducible searchB1_5: refine concepts and Boolean logicB2: extract papersB3: map the literatureE1: synthesize evidenceE2: assess quality / risk of biasG1: run PRISMA checkF3: write the review manuscript
Narrower route
Use this when you already have a stable corpus:
B2B3E1F3
Typical skills
academic-searcherconcept-extractorpaper-screenerpaper-extractorliterature-mapperevidence-synthesizerquality-assessorprisma-checkermanuscript-architect
Typical outputs
- search log
- screening log
- extraction table
- literature map
- synthesis memo or meta-analytic result
- quality assessment
- PRISMA compliance report
- manuscript draft
Starter command
python3 -m bridges.orchestrator task-run \
--task-id B1 \
--paper-type systematic-review \
--topic ai-in-education \
--cwd . \
--research-depth deepCommon narrowing rule
If the review starts producing too many auxiliary artifacts, stay with:
B2B3E1F2orF3
and use --focus-output plus --output-budget.
2. Empirical Paper
Use this when
You are writing a standard empirical paper with a design, dataset, analysis, interpretation, and submission path.
Recommended route
A1: define questionA1_5: generate hypothesesC1: build the designC2/C3: operationalize variables and validate data pathC4: specify robustness logicI1/I2/I3or Stage-I code lane if implementation is substantialF1: manuscript structureF3: full draftF4: tables/figures/results supportG2: reporting checkH1: submission package
Narrower route
Use this when the study is already run and you mainly need writing plus checks:
F1F3F4G2H1
Typical skills
question-refinerhypothesis-generatorstudy-designervariable-constructordataset-finderrobustness-planneranalysis-interpretertable-generatorfigure-specifierreporting-checker
Typical outputs
- question and hypothesis set
- design spec
- variable / dataset plan
- robustness plan
- manuscript draft
- tables and figure specs
- reporting compliance memo
- submission bundle
Starter command
python3 -m bridges.orchestrator task-run \
--task-id C1 \
--paper-type empirical \
--topic policy-effects \
--cwd .Common decision rule
If code is light, stay in the writing/design route. If code becomes central to the paper, switch into the full Stage-I code lane instead of using generic drafting alone.
3. Methods Paper
Use this when
The core contribution is a method, algorithm, pipeline, or code-supported procedure, and the code is first-class evidence.
Recommended route
A1: define problem and contribution claimA3: frame theory or methodological positioningC1: state evaluation designI5: code specificationI6: zero-decision planI7: implementation and profilingI8: review logic and statistical validityI4: reproducibility auditF1: manuscript structureF3: methods paper draftH3: peer-review simulation for harsh stress test
Narrower route
Use this when you are still locking implementation before building:
A1C1I5I6
Typical skills
theory-mapperstudy-designercode-specificationcode-planningcode-executioncode-reviewreproducibility-auditorstats-enginemanuscript-architect
Typical outputs
- method positioning memo
- evaluation design
- code specification
- execution plan
- performance profile
- code review
- reproducibility audit
- methods manuscript draft
Starter command
python3 -m bridges.orchestrator code-build \
--method "Staggered DID" \
--topic policy-effects \
--domain economics \
--focus full \
--paper-type methods \
--cwd .Common decision rule
If you are unsure whether the code lane is necessary, ask:
- Is code a core contribution?
- Will reviewers evaluate reproducibility and implementation quality directly?
- Does the paper need strict audit artifacts such as
code_review.mdandreproducibility_audit.md?
If yes, use the Stage-I route.
4. Theory Paper
Use this when
The paper’s main contribution is conceptual, theoretical, or mechanism-building rather than data-heavy execution.
Recommended route
A1: refine the core questionA1_5: turn it into propositionsA2: map the theory baseA4: identify unresolved theoretical gapB2: targeted literature extractionE1: synthesize conceptual evidenceF1: design the manuscript logicF3: full theory draftG4: tone tighteningH4: fatal-flaw stress test
Narrower route
Use this when the theory base is already stable:
A2A4F1F3
Typical skills
question-refinerhypothesis-generatortheory-mappergap-analyzerpaper-extractorevidence-synthesizermanuscript-architecttone-normalizerfatal-flaw-detector
Typical outputs
- refined conceptual question
- propositions
- theory map
- theoretical gap memo
- theory manuscript draft
- style normalization log
- fatal-flaw memo
Starter command
python3 -m bridges.orchestrator task-run \
--task-id A2 \
--paper-type theory \
--topic organizational-ai-governance \
--cwd .Common decision rule
Do not over-import the code lane into a theory paper unless the method or simulation is itself part of the contribution.
Cross-Playbook Advice
When to go deeper
Go deeper when:
- reviewers will expect reproducibility or checklist evidence
- the paper type itself has strong reporting standards
- the evidence base is contested or heterogeneous
- you need stronger adversarial review
When to stay narrow
Stay narrow when:
- you already have stable inputs
- the task is a revision rather than a greenfield build
- artifact sprawl is becoming expensive
- you only need one core deliverable
Useful controls:
--focus-output--output-budget--research-depth deep--only-target
Related Pages
- Need scenario-based task guidance: Task Recipes
- Need the global skill map: Skills Guide
- Need exact command flags: CLI Reference