> ## Documentation Index
> Fetch the complete documentation index at: https://docs.narrative.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Concepts

> Understand how Narrative I/O works—the architecture, primitives, and design decisions behind the platform

The Concepts section explains the *why* behind Narrative I/O. Rather than step-by-step instructions, you'll find explanations of how the platform works, why it's designed the way it is, and how different pieces fit together.

## Core Primitives

The fundamental building blocks of the platform.

<CardGroup cols={2}>
  <Card title="Data Planes" icon="database" href="/concepts/primitives/data-planes">
    Where your data lives and is processed
  </Card>

  <Card title="Control Plane" icon="sitemap" href="/concepts/primitives/control-plane">
    How Narrative orchestrates data collaboration
  </Card>

  <Card title="Execution Context" icon="crosshairs" href="/concepts/primitives/execution-context">
    How data plane, compute pool, database, and schema determine where operations run
  </Card>

  <Card title="Compute Pools" icon="microchip" href="/concepts/primitives/compute-pools">
    How compute resources are allocated for query execution
  </Card>

  <Card title="Dataset Statistics" icon="chart-column" href="/concepts/primitives/dataset-statistics">
    Column-level metrics that describe your data
  </Card>
</CardGroup>

## Rosetta Stone

Narrative's approach to schema normalization and data mapping.

<CardGroup cols={2}>
  <Card title="Overview" icon="language" href="/concepts/rosetta-stone/overview">
    What Rosetta Stone is and why it matters
  </Card>

  <Card title="How It Works" icon="gears" href="/concepts/rosetta-stone/how-it-works">
    The mechanics of automatic schema mapping
  </Card>

  <Card title="Normalization Model" icon="layer-group" href="/concepts/rosetta-stone/normalization-model">
    How data gets normalized across sources
  </Card>

  <Card title="vs. Apache Ossie" icon="code-compare" href="/concepts/rosetta-stone/vs-apache-ossie">
    How Rosetta Stone differs from the Open Semantic Interchange spec
  </Card>
</CardGroup>

## NQL

The design and philosophy behind Narrative Query Language.

<CardGroup cols={2}>
  <Card title="Design Philosophy" icon="compass-drafting" href="/concepts/nql/design-philosophy">
    Why NQL exists and how it differs from traditional approaches
  </Card>

  <Card title="SQL Comparison" icon="code-compare" href="/concepts/nql/sql-comparison">
    How NQL relates to SQL and when to use each
  </Card>

  <Card title="Type System" icon="shapes" href="/concepts/nql/type-system">
    How NQL handles data types and type safety
  </Card>

  <Card title="JOIN Performance" icon="chart-line" href="/concepts/nql/join-performance">
    Why certain JOIN patterns cause performance problems
  </Card>

  <Card title="Materialized Views" icon="layer-group" href="/concepts/nql/materialized-views">
    Pre-computed query results for performance and caching
  </Card>

  <Card title="Incremental View Maintenance" icon="arrows-rotate" href="/concepts/nql/incremental-view-maintenance">
    How NQL optimizes materialized view refreshes
  </Card>
</CardGroup>

## Identifiers

How identifiers connect records across organizations and systems.

<CardGroup cols={2}>
  <Card title="Identity Graphs" icon="diagram-project" href="/concepts/identifiers/identity-graph">
    How connected components unify identifiers into person-level profiles
  </Card>

  <Card title="Graph Enrichment" icon="circle-nodes" href="/concepts/identifiers/graph-enrichment">
    Strengthening graph structure with third-party linkage data
  </Card>

  <Card title="Addressability Expansion" icon="bullseye-arrow" href="/concepts/identifiers/addressability">
    Improving activation reach by appending additional identifiers
  </Card>
</CardGroup>

## Data Activation

Delivering audience data from Narrative to external platforms.

<CardGroup cols={2}>
  <Card title="Data Activation" icon="bullseye-arrow" href="/concepts/data-activation/overview">
    How connectors deliver audience data to advertising and marketing platforms
  </Card>

  <Card title="Connector Interfaces" icon="plug-circle-bolt" href="/concepts/data-activation/connector-interfaces">
    What a dataset connects to, and how schema compatibility is decided
  </Card>

  <Card title="Audience Studio" icon="users" href="/concepts/data-activation/audience-studio">
    Build, filter, and deliver audiences with a guided visual builder
  </Card>

  <Card title="Lookalike Studio" icon="clone" href="/concepts/data-activation/lookalike-studio">
    Expand reach by modeling audiences that resemble a seed
  </Card>
</CardGroup>

## Architecture

How the platform is built and why.

<CardGroup cols={2}>
  <Card title="Query Processing" icon="microchip" href="/concepts/architecture/query-processing">
    How queries are compiled, optimized, and executed
  </Card>

  <Card title="Data Flow" icon="arrows-split-up-and-left" href="/concepts/architecture/data-flow">
    How data moves through the platform
  </Card>

  <Card title="Sample Data" icon="flask" href="/concepts/architecture/sample-data">
    How samples cross to the control plane
  </Card>

  <Card title="Security Model" icon="shield" href="/concepts/architecture/security-model">
    How Narrative protects your data
  </Card>
</CardGroup>

## Workflows

Automating multi-step data pipelines.

<CardGroup cols={2}>
  <Card title="Workflow Orchestration" icon="diagram-project" href="/concepts/workflows/workflow-orchestration">
    How workflows automate sequential data operations and relate to the jobs system
  </Card>
</CardGroup>

## Webhooks

Push-based notifications for job state changes.

<CardGroup cols={2}>
  <Card title="Webhooks" icon="bell" href="/concepts/webhooks/overview">
    How webhooks deliver notifications when jobs change state
  </Card>
</CardGroup>

## MCP Server for Agents

Connect AI agents to Narrative.

<CardGroup cols={2}>
  <Card title="MCP Server for Agents" icon="robot" href="/concepts/mcp/overview">
    How the Narrative MCP server lets AI agents interact with your data
  </Card>

  <Card title="Skills" icon="sparkles" href="/concepts/mcp/skills">
    Pre-built, harness-agnostic workflows that orchestrate the MCP server
  </Card>
</CardGroup>

## Model Inference

AI-powered operations within your data plane.

<CardGroup cols={2}>
  <Card title="Overview" icon="brain" href="/concepts/model-inference/overview">
    How AI inference works within your infrastructure
  </Card>

  <Card title="Data Privacy" icon="shield" href="/concepts/model-inference/data-privacy">
    How inference keeps data secure in your data plane
  </Card>

  <Card title="Structured Output" icon="brackets-curly" href="/concepts/model-inference/structured-output">
    How JSON Schema ensures predictable responses
  </Card>
</CardGroup>

## Apps

Third-party onboarding and account connection.

<CardGroup cols={2}>
  <Card title="App Invites" icon="envelope-open-text" href="/concepts/apps/app-invites">
    How invite links enable third parties to connect accounts without Narrative authentication
  </Card>
</CardGroup>

## Security

Enterprise security and access management.

<CardGroup cols={2}>
  <Card title="Single Sign-On (SSO)" icon="shield-keyhole" href="/concepts/security/sso">
    How SSO works with Narrative and why it matters for enterprise security
  </Card>

  <Card title="API Key Permissions" icon="lock-keyhole" href="/concepts/security/api-key-permissions">
    How scoped permissions protect your resources and enforce least privilege
  </Card>
</CardGroup>

## Compliance

Privacy regulations and data protection requirements.

<CardGroup cols={2}>
  <Card title="GDPR" icon="shield-check" href="/concepts/compliance/gdpr">
    The EU's General Data Protection Regulation and its requirements
  </Card>

  <Card title="CCPA" icon="scale-balanced" href="/concepts/compliance/ccpa">
    California's privacy law and consumer rights framework
  </Card>
</CardGroup>
