Skip to content
TeamLoop

Subgraphs

Subgraphs are curated collections of entities from your knowledge graph. They help you organize related knowledge for specific projects, topics, or synthesis tasks.

Why Subgraphs?

Section titled “Why Subgraphs?”

Your knowledge graph can grow large with entities from many projects and time periods. Subgraphs let you:

  • Focus - Isolate relevant knowledge for a specific task
  • Organize - Group entities by project, team, or topic
  • Synthesize - Generate documents from curated knowledge
  • Share - Create reusable knowledge collections

Creating Subgraphs

Section titled “Creating Subgraphs”

From a Semantic Query

Section titled “From a Semantic Query”

Let TeamLoop find relevant entities:

teamloop_create_subgraph:
  name: "Auth System Decisions"
  description: "All decisions related to authentication"
  query: "authentication and authorization"
  limit: 30

From Specific Entities

Section titled “From Specific Entities”

Include exact entities by ID:

teamloop_create_subgraph:
  name: "Q4 Architecture Review"
  description: "Entities for Q4 2024 architecture review"
  entity_ids:
    - "uuid-1"
    - "uuid-2"
    - "uuid-3"

Viewing Subgraphs

Section titled “Viewing Subgraphs”

Get by ID

Section titled “Get by ID”
teamloop_get_subgraph:
  subgraph_id: "subgraph-uuid"

Get by Name

Section titled “Get by Name”
teamloop_get_subgraph:
  name: "Auth System Decisions"

Expanding Subgraphs

Section titled “Expanding Subgraphs”

Discover connected entities you might have missed:

Basic Expansion

Section titled “Basic Expansion”
teamloop_expand_subgraph:
  subgraph_id: "subgraph-uuid"
  depth: 1

Finds entities one relationship hop away from current members.

Filtered Expansion

Section titled “Filtered Expansion”
teamloop_expand_subgraph:
  subgraph_id: "subgraph-uuid"
  depth: 2
  include_types: ["DECISION", "COMPONENT"]

Only include specific entity types.

Auto-Add

Section titled “Auto-Add”
teamloop_expand_subgraph:
  subgraph_id: "subgraph-uuid"
  depth: 1
  auto_add: true

Automatically add found entities to the subgraph.

Use Cases

Section titled “Use Cases”

Project Context

Section titled “Project Context”

Create subgraphs for specific projects to gather all relevant decisions and context.

Architecture Review

Section titled “Architecture Review”

Gather all relevant decisions for a review, then expand to find related components.

Team Knowledge

Section titled “Team Knowledge”

Create subgraphs per team to organize domain-specific knowledge.

Incident Investigation

Section titled “Incident Investigation”

After an incident, gather relevant knowledge to understand what led to the issue.

Subgraphs for Synthesis

Section titled “Subgraphs for Synthesis”

Subgraphs are the input for document synthesis:

  1. Create focused subgraph
  2. Expand to include related context
  3. Generate ADR, PRD, or brief

Best Practices

Section titled “Best Practices”

1. Name Descriptively

Section titled “1. Name Descriptively”

Use clear, specific names like “Q4 2024 Database Scaling Decisions”.

2. Start Focused, Then Expand

Section titled “2. Start Focused, Then Expand”

Begin with a narrow query, review results, then expand selectively.

3. Use for Synthesis

Section titled “3. Use for Synthesis”

The best subgraphs have 10-50 entities, include multiple entity types, and cover the topic thoroughly.

4. Include Context

Section titled “4. Include Context”

Add description for future reference.

Limitations

Section titled “Limitations”
  • Subgraphs are user-scoped (personal to your account)
  • Maximum 50 entities per query-based creation
  • Expansion limited to 3 hops
  • Names should be unique per user

Next Steps

Section titled “Next Steps”