synthesize

Create and incrementally build synthesis documents from multiple sources.

Output Location

All synthesis documents go in: my-vault/06 Knowledge Base/Synthesis/[Topic]/

Structure:

my-vault/06 Knowledge Base/Synthesis/
└── ADHD/
    ├── ADHD Synthesis.md              # Main synthesis
    ├── ADHD Sources.md                # Sources table + processing log
    └── ADHD Medications Synthesis.md  # Sub-topic (if created)

Queue Files

Queues live in: .claude/skills/synthesize/references/queues/[topic].json

{
  "name": "ADHD",
  "topic_folder": "ADHD",
  "batch_size": 3,
  "max_discovered_per_source": 3,
  "watch_patterns": [
    "my-vault/06 Knowledge Base/Capture/Videos/**/*ADHD*.md",
    "my-vault/01 Inbox/*adhd*.md",
    "my-vault/04 Personal/Health/*ADHD*.md"
  ],
  "sources": [
    {"path": "my-vault/path/to/note.md", "status": "pending", "type": "local"},
    {"path": "my-vault/path/to/video.md", "status": "processed", "type": "local"},
    {"url": "https://example.com/study", "status": "pending", "type": "web",
     "discovered_from": "src-2", "context": "Key study on medication timing"},
    {"search": "Barkley 2023 executive function", "status": "pending", "type": "search",
     "discovered_from": "src-2", "context": "Referenced as foundational research"}
  ],
  "last_run": "2026-01-14T10:00:00Z"
}

Source types:

• local - Path to existing note in my-vault
• web - URL to fetch and process
• search - Search query to find the source (use WebSearch, then fetch best result)

Source status values: pending, processed, skipped

watch_patterns: Glob patterns for /synthesize update to scan. Paths matching these patterns get added to the queue automatically (if not already present).

Commands

• /synthesize [topic] - Continue processing the named synthesis
• /synthesize list - Show all active synthesis queues and progress
• /synthesize new [topic] - Create a new synthesis queue
• /synthesize add [topic] [path-or-glob] - Add sources to a queue
• /synthesize update [topic] - Scan watch_patterns for new sources and add to queue

Architecture

This skill uses a coordinator + subagent pattern for efficient processing:

• Coordinator (Sonnet/Opus): Manages state, spawns extractors, merges findings into synthesis
• Extractors (Haiku subagents): Each reads one source, extracts structured findings in parallel

This allows processing 6-10 sources per batch instead of 2-3, with ~3x throughput improvement.

Workflow

Starting a Session

1. Load queue file for the topic
2. Read the main synthesis doc (or create from template if first run)
3. Read the sources file
4. Identify next N pending sources (N = 6-10 for parallel extraction)

Phase 1: Parallel Extraction (Haiku Subagents)

Spawn 6-10 Haiku extractors in parallel using the Task tool:

Task tool call:
- model: haiku
- subagent_type: general-purpose
- prompt: (see Extractor Prompt Template below)

Extractor Prompt Template:

Read this file and extract [TOPIC]-relevant findings in a structured format.

FILE: [full path to source]

Return your findings as a simple list in this format:
CATEGORY: [Category Name]
- Finding 1 (be specific, include numbers/names if mentioned)
- Finding 2
...

Only include substantive findings relevant to understanding [TOPIC].
Skip metadata, timestamps, and filler.
If the source has little new information, just return "MINIMAL_CONTENT".

For web sources, modify prompt to use WebFetch first:

1. Use WebFetch to retrieve: [URL]
2. Extract [TOPIC]-relevant findings from the content...

For search sources, modify prompt to search first:

1. Use WebSearch to find: [search query]
2. Use WebFetch on the best result
3. Extract [TOPIC]-relevant findings...

Phase 2: Merge Findings (Coordinator)

Once all extractors return:

1. Collect all extraction results
2. Review for:
   • New findings to add to existing categories
   • Findings that warrant new categories
   • Contradictions with existing content → add to Open Questions
   • Dense categories → add to Suggested Sub-Topics
3. Update synthesis doc with citations (^[src-N])
4. Add sources to Sources table
5. Mark sources as processed in queue

Phase 3: Discovery (Coordinator)

While reviewing extractions, watch for references worth following up:

• Studies or papers cited
• Articles or books mentioned
• Other videos or talks referenced
• Experts or researchers named

Limit: 3 discovered sources per source processed.

Discovery

While processing each source, watch for references worth following up:

• Studies or papers cited
• Articles or books mentioned
• Other videos or talks referenced
• Experts or researchers named (for potential lookup)

Limit: 3 discovered sources per source processed.

For each valuable reference:

1. Check if already in queue (deduplicate by URL, title, or path)
2. Add to queue with:
   • type: web if URL available, search if just a name/title
   • discovered_from: source ID where you found it
   • context: why it's relevant (1 sentence)
   • status: pending

Prioritize discoveries that:

• Are directly cited as evidence for claims
• Come from credible sources (peer-reviewed, recognized experts)
• Fill gaps in the current synthesis

Skip discovering:

• Tangential references not central to the topic
• Sources that would require paid access (note in processing log if significant)
• Generic resources (e.g., "see Wikipedia for more")

Ending a Session

1. Write updated synthesis doc
2. Write updated sources file
3. Write updated queue file with new last_run timestamp
4. Add entry to Processing Log (include discovery count)
5. Report:

   Processed X items. Discovered Y new sources.
   Z items remaining. Run `/synthesize [topic]` to continue.
   

If all sources processed:

Synthesis complete. X total sources processed.
Review Suggested Sub-Topics for potential expansion.

Updating a Synthesis (/synthesize update [topic])

Use this to find new sources that match watch_patterns without reprocessing old ones.

1. Load queue file for the topic
2. Collect all paths from watch_patterns using Glob
3. Filter out any paths already in sources (regardless of status)
4. Add new matches to sources with:
   • type: local
   • status: pending
5. Update queue file
6. Report:

   Found X new sources matching watch_patterns.
   Queue now has Y pending items. Run `/synthesize [topic]` to process.
   

If no new sources found:

No new sources found. Synthesis is up to date with watch_patterns.

Tip: Run /synthesize update [topic] periodically after adding new notes or video summaries to keep the synthesis current.

Synthesis Document Template

Create at: my-vault/06 Knowledge Base/Synthesis/[Topic]/[Topic] Synthesis.md

---
class: Synthesis
topic: [Topic Name]
created: [Date]
lastUpdated: [Date]
status: in-progress
---

## Overview

[2-3 sentence summary of the topic - updated as understanding deepens]

## Key Findings

### [Category]

- Finding with specific details ^[src-1]
- Another finding that multiple sources support ^[src-1] ^[src-3]

<!-- Add categories as needed based on source content -->

## Open Questions

<!-- Contradictions, uncertainties, areas needing human judgment -->

- **[Topic]**: Source A says X ^[src-1], but Source B says Y ^[src-2].

## Suggested Sub-Topics

<!-- Categories that could warrant their own synthesis -->

- **[Sub-topic]** - X sources touched on this; may warrant dedicated synthesis

---
*Sources and processing log: [[Topic Sources]]*

Sources Document Template

Create at: my-vault/06 Knowledge Base/Synthesis/[Topic]/[Topic] Sources.md

---
class: Note
parent: "[[Topic Synthesis]]"
---

## Sources

| ID | Title | Date | Type | Discovered | Path/URL |
|----|-------|------|------|------------|----------|
| src-1 | Source Title | 2025-03 | Video | - | [[path/to/note]] |
| src-2 | Study Name | 2024-11 | Web | from src-1 | [link](url) |

## Processing Log

- **2026-01-14**: Initial synthesis. Processed 3 items. Created categories for X, Y, Z. Discovered 2 new sources.
- **2026-01-15**: Processed 3 items. Flagged contradiction on [topic]. Discovered 1 new source.

Length Discipline

Core content (Overview through Suggested Sub-Topics) must stay under 300 lines.

Guidelines:

• Overview: 5 lines max
• Categories: 8 max in main doc
• Points per category: 15 max
• Open Questions: 10 max

When a category exceeds ~40-50 lines or has 5+ sources going deep:

1. Summarize tightly in the main doc (5-10 key points)
2. Add to Suggested Sub-Topics
3. Sub-topic syntheses get their own doc in the same folder, linking back to parent

Handling Contradictions

When new information conflicts with existing content:

1. Do not silently replace the existing information
2. Move both claims to Open Questions with citations:

   - **Medication timing**: Take with food for reduced side effects ^[src-2],
     but empty stomach for faster absorption ^[src-5]. May depend on specific medication.
   

3. If a clear resolution exists (newer research, more credible source, broader consensus), note it:

   - **Resolved**: Earlier sources suggested X, but consensus now supports Y ^[src-8] ^[src-9] ^[src-10]
   

Citation Format

Use ^[source-id] inline, where source-id matches the ID column in the Sources table.

• Single source: Finding here ^[src-1]
• Multiple sources: Well-supported finding ^[src-1] ^[src-3] ^[src-7]
• Conflicting sources: Note in Open Questions section

Adding Sources to Queue

Manual Addition

/synthesize add adhd my-vault/path/to/specific/note.md

Glob Pattern

/synthesize add adhd "my-vault/06 Knowledge Base/Capture/Videos/**/*ADHD*.md"

By Tag (search and add)

When adding, search for relevant notes:

• Notes with topic in filename
• Notes with relevant tags
• Video summaries from relevant channels

Deduplicate against existing sources in queue before adding.

Creating Sub-Topic Syntheses

When a sub-topic warrants its own document:

1. Create new queue: /synthesize new "ADHD Medications"
2. Set topic_folder to match parent: "ADHD" (keeps files together)
3. Add relevant sources (can include already-processed sources from parent for deeper dive)
4. In parent synthesis, add link: See also: [[ADHD Medications Synthesis]]
5. In sub-topic synthesis Overview, note parent: Deep-dive from [[ADHD Synthesis]]