Skip to content
TeamLoop

Synthesis

TeamLoop’s synthesis feature generates structured documents from your knowledge graph. Transform curated subgraphs into ADRs, PRDs, executive briefs, and more.

How Synthesis Works

Section titled “How Synthesis Works”
  1. Create a subgraph with relevant entities
  2. Select a template (brief, PRD, ADR)
  3. Start synthesis job
  4. Poll for completion and get output

Starting a Synthesis Job

Section titled “Starting a Synthesis Job”
teamloop_synthesize:
  subgraph_id: "your-subgraph-uuid"
  template_type: "adr"
  additional_context: "Focus on security implications"

Parameters:

ParameterRequiredDescription
subgraph_idYesThe subgraph to synthesize from
template_typeYesbrief, prd, or adr
additional_contextNoExtra instructions or focus areas

Checking Job Status

Section titled “Checking Job Status”
teamloop_get_synthesis_job:
  job_id: "abc-123-def-456"

Returns job status (pending, processing, completed, failed) and output when complete.

Template Types

Section titled “Template Types”

Brief

Section titled “Brief”

Executive summary of the knowledge in a subgraph.

Best for:

  • Leadership updates
  • Project summaries
  • Quick overviews

PRD (Product Requirements Document)

Section titled “PRD (Product Requirements Document)”

Product requirements derived from knowledge.

Best for:

  • Feature specifications
  • Project scoping
  • Planning documents

ADR (Architecture Decision Record)

Section titled “ADR (Architecture Decision Record)”

Formal documentation of architectural decisions.

Best for:

  • Technical documentation
  • Decision records
  • Architecture reviews

Workflow Example

Section titled “Workflow Example”
  1. Build Knowledge - Query and extract relevant entities
  2. Create Focused Subgraph - Group related entities
  3. Expand if Needed - Add related context
  4. Synthesize - Generate the document
  5. Get Result - Poll for completion

Canceling Jobs

Section titled “Canceling Jobs”

Cancel pending or in-progress jobs:

teamloop_cancel_synthesis_job:
  job_id: "abc-123-def-456"

Best Practices

Section titled “Best Practices”

1. Curate Your Subgraph

Section titled “1. Curate Your Subgraph”

Better input = better output. Use focused queries rather than broad ones.

2. Use Additional Context

Section titled “2. Use Additional Context”

Guide the synthesis with specific instructions about focus areas or audience.

3. Review and Iterate

Section titled “3. Review and Iterate”

Synthesis output is a starting point - review for accuracy, add missing context, and validate technical details.

4. Right Template for Right Purpose

Section titled “4. Right Template for Right Purpose”
Use CaseTemplate
Leadership updatebrief
New feature specprd
Technical decision recordadr

Output Quality

Section titled “Output Quality”

Synthesis quality depends on:

  1. Subgraph richness - Include decisions, rationale, alternatives
  2. Entity completeness - Fill in descriptions, dates, relationships
  3. Context clarity - Use additional_context to guide focus
  4. Temporal coverage - Include historical context

Limitations

Section titled “Limitations”
  • Synthesis may take 30-120 seconds
  • Maximum subgraph size: 100 entities
  • Output is AI-generated - always review
  • Complex topics may need multiple synthesis runs

Next Steps

Section titled “Next Steps”