synthesis-patterns
Multi-Source Synthesis Patterns
When answering questions that require information from multiple Glean sources, use these patterns to combine and synthesize effectively.
When This Applies
Use this approach when:
- A question spans documents, meetings, people, and code
- You need to cross-reference information from different sources
- Results from one source need context from another
- Building a comprehensive answer from partial information
- Sources seem to conflict or overlap
BE SKEPTICAL
When synthesizing across multiple sources, aggressive vetting is essential:
Source Quality Test
- Is each source authoritative?
- ✅ INCLUDE: Official docs, code, recent meetings
- ⚠️ CONTEXT: Secondary sources, somewhat dated
- ❌ EXCLUDE: Hearsay, speculation, very old information
Recency vs Authority
- When sources disagree on recency, choose wisely:
- ✅ TRUST: Recent information from official source
- ⚠️ CAUTION: Very recent but unofficial vs stale but official
- ❌ AVOID: Treating old info as current just because it's "official"
Completeness Check
- Do you have the full picture?
- ✅ INCLUDE: 3+ sources align, comprehensive coverage
- ⚠️ CONTEXT: Limited sources, note gaps explicitly
- ❌ EXCLUDE: Single source for multi-faceted questions
Conflict Resolution
- When sources conflict, don't hide it:
- ✅ INCLUDE: Conflict + explanation of which is likely correct
- ❌ EXCLUDE: Picking one source without acknowledging disagreement
Filter Out:
- Unattributed claims
- Information older than 3 months (unless structure/architecture)
- Synthesis that glosses over fundamental disagreements
- "I synthesized this" without showing your work
Say "I don't know" when:
- Sources are missing or conflicting
- Information is too stale to be reliable
- You lack sufficient data to synthesize confidently
The Synthesis Framework
1. Identify Information Types Needed
Before querying, determine what types of information are needed:
| Information Type | Glean Tool | Use When |
|---|---|---|
| Official documentation | search |
Need authoritative specs, policies |
| Real-time context | meeting_lookup |
Need recent discussions, decisions |
| People/org structure | employee_search |
Need ownership, expertise |
| Code evidence | code_search |
Need implementation truth |
| User's own context | memory, user_activity |
Need personalization |
| AI synthesis | chat |
Need reasoning across sources |
2. Query in Optimal Order
Recommended order for comprehensive synthesis:
- Start broad with
chat- Get AI-synthesized overview - Verify with
search- Find authoritative documents - Add recency with
meeting_lookup- Get latest discussions - Clarify ownership with
employee_search- Identify who to ask - Ground in reality with
code_search- What's actually implemented
3. Cross-Reference Pattern
When you have results from multiple sources, cross-reference:
## Finding: [Topic]
### From Documentation
- [What docs say] - Source: [doc title] ([link])
### From Recent Meetings
- [What was discussed] - Source: [meeting date]
### From Code
- [What's implemented] - Source: [file/repo]
### Synthesis
Based on these sources: [Your synthesized answer]
### Confidence
- Documentation: [Current/Stale/Missing]
- Meeting Context: [Recent/Old/None]
- Code Evidence: [Present/Partial/None]
4. Handle Conflicts
When sources disagree:
## Conflicting Information Detected
| Topic | Source A Says | Source B Says |
|-------|---------------|---------------|
| [Topic] | [Claim from doc] | [Claim from meeting] |
**Most Likely Truth**: [Your assessment based on recency, authority]
**Recommendation**: Verify with [person/source]
Synthesis Patterns by Use Case
Pattern: "What is X?"
chat- Get overviewsearch- Find official definitionemployee_search- Find owner to verify- Synthesize: Combine AI overview + official doc + owner context
Pattern: "Who should I talk to about X?"
employee_search- Find by rolecode_search- Find by code activitysearch- Find by doc authorship- Synthesize: Rank by multiple signal strength
Pattern: "What's the status of X?"
chat- Get current status summarymeeting_lookup- Find recent discussionssearch- Find tracking docs (Jira, etc.)- Synthesize: Combine with recency weighting
Pattern: "How do we do X?"
search- Find process docscode_search- Find implementationmeeting_lookup- Find recent changes- Synthesize: Doc process + code reality + recent updates
Output Best Practices
- Cite every source - Include links for all claims
- Note recency - When was this information last updated?
- Flag uncertainty - Be clear about gaps
- Suggest verification - Point to people who can confirm
- Acknowledge conflicts - Don't hide disagreements
Example Synthesis Output
## [Question/Topic]
### Answer
[Direct answer to the question]
### Supporting Evidence
| Source | What It Says | Last Updated |
|--------|--------------|--------------|
| [Doc Title] | [Key info] | [Date] |
| [Meeting] | [Key info] | [Date] |
| [Code/Repo] | [Key info] | [Date] |
### Confidence Assessment
- **Overall Confidence**: [High/Medium/Low]
- **Data Freshness**: [Current/Mostly current/Some stale]
- **Source Agreement**: [Strong/Partial/Conflicting]
### Gaps & Recommendations
- [What's missing or uncertain]
- [Who to verify with if critical]
Relationship to Other Skills
This skill works with:
glean-tools-guide- For tool selectionconfidence-signals- For noting data qualityenterprise-search- For document searchesmeeting-context- For meeting queriespeople-lookup- For people queries
More from gleanwork/claude-plugins
code-exploration
Use when the user asks about internal code, implementations, patterns across repositories, or needs to understand how something is built. Triggers on "how is X implemented", "where is the code for", "find the implementation of", "what repos contain", "who wrote the code for", or code architecture questions about internal systems.
15glean-tools-guide
Use when Glean MCP tools are available and you need guidance on which tool to use, how to format queries, or best practices for enterprise search. This skill provides tool selection logic and query optimization for Glean integrations. Auto-triggers when mcp__glean tools are being considered.
14activity-synthesis
Use when the user asks about their recent work, what they've been doing, their contributions, or needs to recall past activity. Triggers on phrases like "what have I been working on", "what did I do last week", "my recent activity", "what have I accomplished", "summarize my work", "what projects am I on", or when the user needs to recall or reflect on their own work.
13project-awareness
Use when the user asks about project status, ownership, or context. Triggers on phrases like "status of X project", "who owns Y", "what's happening with Z", "project update", "where does the project stand", "what's the state of", "who's working on", or when needing quick project context without a full analysis.
13people-lookup
Use when the user asks about people, employees, team members, org structure, or expertise. Triggers on phrases like "who works on", "who is responsible for", "who owns", "find someone who knows", "who should I talk to", "who reports to", "team members", "org chart", or any question starting with "who" about the company.
12enterprise-search
Use when the user asks about company documents, internal wikis, policies, specifications, design docs, RFCs, or enterprise knowledge. Triggers on phrases like "find the doc about", "what's our policy on", "where is the spec for", "company guidelines", "internal documentation", or when searching for information that would be in enterprise systems rather than the local codebase.
12