vault-synthesize
Vault Synthesize
Research assistant for the vault's own content. Searches across project folders, reads the best sources, and synthesizes a consolidated note.
Workflow
-
Clarify the topic if needed. Accept a topic, question, or keyword cluster. Example: "Claude Code agent teams", "browser automation workflows", "MCP server patterns".
-
Run multiple searches to cast a wide net — use 2-4 query variations:
obsidian search:context query="<primary term>" limit=10 obsidian search:context query="<synonym or related term>" limit=10 obsidian search:context query="<specific aspect>" limit=8Collect all matching file paths. Deduplicate. Prefer matches in
gemini3_summary.txtandREADME.mdfiles overtranscript.txt. -
Rank results by relevance:
- Matches in multiple queries = higher priority
gemini3_summary.txt>README.md>transcript.txt- Folders whose names match the topic = higher priority
- Aim for the top 5-10 sources
-
Read the top sources using the
Readtool:- For each top folder, read
gemini3_summary.txtif it exists, elseREADME.md - Skim
transcript.txtonly if neither summary nor README is available - Read up to 10 files total
- For each top folder, read
-
Synthesize a note. Write to disk using the
Writetool (content will be long):--- description: Synthesis of vault knowledge on <topic> title: Synthesis — <Topic> date: YYYY-MM-DD source: vault-synthesize --- # Synthesis — <Topic> ## Overview 2-3 paragraph synthesis of what this vault collectively knows about the topic. Write from the perspective of someone who has read all the sources. ## Key Insights 1. **Insight title** — explanation. Source: [[folder_name/gemini3_summary]] 2. **Insight title** — explanation. Source: [[folder_name/README]] ... ## Patterns & Approaches How different sources approach the topic — agreements, disagreements, different angles. ## Source Notes | Project | Description | Link | |---------|-------------|------| | folder_name | What this source covers | [[folder_name/gemini3_summary]] | ... ## Gaps What this vault does NOT cover well on this topic. What's missing or outdated. -
Write the file:
Write tool → <vault-root>/Synthesis — <Topic>.md -
Log to daily note:
obsidian daily:append content="### HH:MM — Synthesized: <Topic>\nCreated [[Synthesis — <Topic>]] from <n> vault sources.\n" -
Report the note path, number of sources consulted, and the top 3 insights found.
Tips
- Capitalize synthesis notes with " — " separator:
Synthesis — Agent Teams.md - If the vault has many sources (>15 relevant), narrow to the 8-10 most specific rather than trying to read all
- The
## Gapssection is often the most valuable — note what the user should look for next - If sources conflict, note it explicitly in
## Patterns & Approaches
More from az9713/claude-code-obsidian
vault-moc
Generate a Map of Content (MOC) note that categorizes and wikilinks vault project folders by theme. Can create a full vault index or a focused MOC for a specific category (e.g., "skills", "agents", "browser automation"). Use when wanting to create a navigational index of vault content.
2vault-save
Capture insights, solutions, or learnings from the current Claude Code conversation into a formatted Obsidian note with wikilinks. Use when the user wants to save something discovered during a conversation — a technique, a solution, a workflow decision, or a key insight.
2defuddle
Extract clean markdown content from web pages using Defuddle CLI, removing clutter and navigation to save tokens. Use instead of WebFetch when the user provides a URL to read or analyze, for online documentation, articles, blog posts, or any standard web page.
1json-canvas
Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with .canvas files, creating visual canvases, mind maps, flowcharts, or when the user mentions Canvas files in Obsidian.
1vault-journal
Log a research entry to today's Obsidian daily note, automatically finding and wikilinking related vault projects. Use when the user wants to capture something they learned, worked on, or found interesting about Claude Code or AI tooling.
1obsidian-cli
Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their Obsidian vault, manage notes, search vault content, perform vault operations from the command line, or develop and debug Obsidian plugins and themes.
1