| name | evidence-driven-writing |
| description | Use when writing or revising Introduction, Related Work, background, literature synthesis, or any section where references must drive claims |
Evidence-Driven Writing
This skill turns a literature pool into manuscript argument. It is required for Introduction, Related Work, and any background section with citations.
Hard Gate
Do not write the section until an evidence map and paragraph blueprint exist.
Required artifacts:
refs/evidence-map.md or plan/evidence-map.md
plan/chapter-blueprints/<section>-blueprint.md
plan/review/evidence-coverage.md
Evidence Map
Create one row per usable source:
| Source ID | Citation | Source type | Abstract-level finding | Usable fact | Supported claim | Citation slot | Risk |
|---|
Rules:
- Use the user's literature pool first.
- Use only information present in title, abstract, DOI metadata, or user-provided notes unless full text is available.
- One citation must support one concrete claim, not a vague field statement.
- Mark weak or indirect support as
Risk: indirect.
Paragraph Blueprint
For each paragraph, define:
### Paragraph N
- Role: context / method landscape / limitation / gap / contribution
- Main claim:
- Evidence IDs:
- Contrast or transition:
- Forbidden content: