Paper Type Playbooks
This page gives standard example routes for the five canonical paper types:
systematic-reviewempiricalqualitativemethodstheory
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. Qualitative Paper
Use this when
The paper’s core evidence comes from interviews, case studies, ethnography, documents, or process tracing, and the goal is analytic depth about meaning, mechanism, or process rather than statistical estimation.
Recommended route
A1: refine the qualitative research question, setting, and unit of analysisA1_5: define working propositions or sensitizing conceptsA3: anchor the theoretical lens or process framingA4: specify the qualitative gap and expected contributionB2: targeted paper readingB6: literature map around mechanism, process, and rival explanationsC1: build the qualitative designC2: write interview / observation / document protocolsC3: lock coding, memoing, and comparison logicC1_5: define rival interpretations / disconfirming casesD1: ethics and data governance packageF1: manuscript structureF3: full qualitative draftG1: reporting check (SRQR / COREQ)H4: fatal-flaw stress test
Narrower route
Use this when fieldwork is done and you mainly need analysis-to-manuscript conversion:
C3F1F3G1H1
Typical skills
question-refinerhypothesis-generatortheory-mappergap-analyzerpaper-extractorliterature-mapperstudy-designerrival-hypothesis-designeranalysis-interpreterreporting-checkermanuscript-architect
Typical outputs
- qualitative RQ set and contribution memo
- case / participant sampling logic
- interview guide or observation protocol
- coding and memoing plan
- findings interpretation memo
- manuscript draft
- SRQR / COREQ checklist
- fatal-flaw memo
Starter command
python3 -m bridges.orchestrator task-run \
--task-id C1 \
--paper-type qualitative \
--topic platform-governance-practices \
--domain business-management \
--cwd .Common decision rule
Use the qualitative route when the paper needs deep explanation of process, meaning, interpretation, or mechanism and the evidence base is interviews, cases, fieldnotes, or documents rather than a model-ready dataset.
4. 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.
5. 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