dr-synthesize

/dr-synthesize

Synthesize 2+ deep-research raw reports into a single markdown synthesis with a mandatory ## Source Reports header preserving absolute paths to originals.

Combine 2+ deep-research raw reports into a single synthesis. The synthesis is always a new file — raw inputs are never edited.

Companion to /deep-research. This skill consumes /deep-research outputs (or any deep-research raw reports with the canonical frontmatter). Called automatically by /deep-research --synthesize, but also usable standalone for ad-hoc synthesis of older reports.

Argument hint

<archived-path-1> <archived-path-2> [<archived-path-N>...] [--out <output-path>] [--topic <override>]

You need at least 2 input paths. Reports must already be archived in canonical project locations (frontmatter with date:, topic:, tool: fields).

Risk escalation: Auto for synthesis writes (new file in archive). Per-item confirm if --out overwrites an existing file.

---

Phase 1 — Validate inputs

For each path argument:

• Exists and is non-empty
• Has YAML frontmatter (date, topic, tool fields present)
• Lives in a project raw-inputs/ folder, e.g.:
  • ~/projects/*/raw-inputs/
  • ~/Documents/research/*/raw-inputs/
  • ~/Documents/research/*/<paper-folder>/raw-inputs/
• Legacy paths (e.g., a single central archive directory) are warned about; the central directory should hold INDEX only after federated migration.

If --topic is not provided, infer from frontmatter (must match across inputs; warn on mismatch).

Determine output project folder (Phase 3 --out default):

• If all inputs share the same parent raw-inputs/ directory → write synthesis there.
• If inputs span multiple project folders → use the commissioning project (the folder of the first argument). Cross-project synthesis stubs are out of scope for v1.

Phase 2 — Build synthesis prompt

Construct an internal prompt that:

1. Lists each input with its absolute path + tool + date + 1-line preview
2. Asks the model to identify: agreements, contradictions, gaps, unique insights per source
3. Produces a synthesis matching the schema in Phase 3