synthesis-writer

Synthesis Writer

Triggers & routing

• Trigger: synthesis, evidence synthesis, systematic review writing, comprehensive writing, SYNTHESIS.md.
• Use when: evidence-review After completing screening+extraction (including bias assessment), enter the writing phase (C5).
• Skip if: not yet papers/extraction_table.csv(or protocol/screening is not yet complete).
• Network: none.
• Guardrail: Use the extraction table as the evidence base; clearly state limitations and bias; do not expand conclusions without data support.

Transforms the extraction table into the final evidence-review narrative.

Input

• papers/extraction_table.csv

Optional:

• output/PROTOCOL.md
• DECISIONS.md

Output

• output/SYNTHESIS.md

Contract

The synthesis must include stable sections:

• ## Included studies summary
• ## Findings by theme
• ## Risk of bias
• ## Supported conclusions
• ## Needs more evidence

Script boundary

scripts/run.py should:

• summarize extracted evidence conservatively
• keep conclusions bounded by table contents
• render the stable section structure

It should not invent findings not grounded in the extraction table.

Acceptance

• output exists
• includes all stable sections
• stays table-grounded and bounded

Non-goals

• upstream extraction repair
• free-form speculative discussion