# Recce Docs

> Recce is a Data Review Agent that validates dbt pull requests before merge. The docs cover Recce Cloud (managed) and Recce OSS (local CLI), with guides for connecting Git and warehouses, running data diffing and column-level lineage, collaborating on checklists, and wiring CI/CD. Use this index to find the right page in one request.

## What's Recce

- [Recce: Data Review Agent for dbt Pull Requests](https://docs.reccehq.com/index.md): product overview and what Recce validates between environments
- [Cloud vs Open Source](https://docs.reccehq.com/whats-recce/cloud-vs-oss.md): compare Recce Cloud and Recce OSS to pick the right fit
- [Glossary](https://docs.reccehq.com/whats-recce/glossary.md): definitions for Recce, dbt, and data validation terms used across the docs

## Getting Started

- [Get Started with Recce Cloud](https://docs.reccehq.com/getting-started/start-free-with-cloud.md): set up Recce Cloud to automate dbt validation on pull requests
- [OSS Setup](https://docs.reccehq.com/getting-started/oss-setup.md): install and run Recce OSS locally for manual dbt validation
- [Jaffle Shop Tutorial (OSS)](https://docs.reccehq.com/getting-started/jaffle-shop-tutorial.md): hands-on walkthrough using the Jaffle Shop sample dbt project

## Setup Guides

- [Connect Your Repository](https://docs.reccehq.com/setup-guides/connect-git.md): connect GitHub or GitLab to Recce Cloud
- [Connect Data Warehouse](https://docs.reccehq.com/setup-guides/connect-to-warehouse.md): connect Snowflake, Databricks, BigQuery, or Redshift
- [Environment Setup](https://docs.reccehq.com/setup-guides/environment-setup.md): configure dbt profiles and CI/CD variables for base vs current comparison
- [Environment Best Practices](https://docs.reccehq.com/setup-guides/environment-best-practices.md): reliable patterns for shared production base and per-PR schemas
- [Advanced Environment Setup](https://docs.reccehq.com/setup-guides/environment-advanced.md): build a session base per PR to silence false alarms from non-deterministic SQL
- [dbt Cloud Setup](https://docs.reccehq.com/setup-guides/dbt-cloud-setup.md): integrate Recce with dbt Cloud artifacts
- [Setup CD](https://docs.reccehq.com/setup-guides/setup-cd.md): automate baseline updates after every merge to main
- [Setup CI](https://docs.reccehq.com/setup-guides/setup-ci.md): validate dbt data changes on every pull request
- [Claude Plugin](https://docs.reccehq.com/setup-guides/claude-plugin.md): use Recce inside Claude Code with automated MCP and artifact setup
- [MCP Server (AI Agents)](https://docs.reccehq.com/setup-guides/mcp-server.md): connect Claude Code, Cursor, or Windsurf to validate data via natural language

## Using Recce

- [Admin Setup](https://docs.reccehq.com/using-recce/admin-setup.md): configure your Recce Cloud organization, projects, and members
- [Data Developer Workflow](https://docs.reccehq.com/using-recce/data-developer.md): validate dbt changes through the development lifecycle
- [Data Reviewer Workflow](https://docs.reccehq.com/using-recce/data-reviewer.md): review and approve dbt data changes on pull requests
- [CLI Commands](https://docs.reccehq.com/using-recce/cli-commands.md): command-line reference for Recce Cloud and Recce OSS
- [Workflow in OSS](https://docs.reccehq.com/using-recce/oss-workflow.md): local OSS workflow for state files, checklists, and sharing results

## What You Can Explore

- [Data Review Summary](https://docs.reccehq.com/what-you-can-explore/summary.md): AI-generated pull request summary that explains the change and its impact
- [Lineage Diff](https://docs.reccehq.com/what-you-can-explore/lineage-diff.md): visualize added, modified, and removed models between base and current
- [Code Change](https://docs.reccehq.com/what-you-can-explore/code-change.md): inspect SQL and config diffs for each changed model
- [Column-Level Lineage](https://docs.reccehq.com/what-you-can-explore/column-level-lineage.md): trace upstream and downstream relationships at the column level
- [Impact Radius](https://docs.reccehq.com/what-you-can-explore/impact-radius.md): identify downstream models and columns affected by a change
- [Breaking Change Analysis](https://docs.reccehq.com/what-you-can-explore/breaking-change-analysis.md): categorize modified models as breaking, non-breaking, or partial
- [Data Diffing](https://docs.reccehq.com/what-you-can-explore/data-diffing.md): row count diff, profile diff, value diff, top-K diff, histogram diff, and query
- [Multi-Models](https://docs.reccehq.com/what-you-can-explore/multi-models.md): run checks across multiple models at once

## Collaboration

- [Checklist](https://docs.reccehq.com/collaboration/checklist.md): save validation checks as proof-of-correctness for the PR
- [Activity](https://docs.reccehq.com/collaboration/activity.md): audit trail of approvals, comments, and edits per check
- [Preset Checks](https://docs.reccehq.com/collaboration/preset-checks.md): turn recurring checks into defaults for every PR
- [Share](https://docs.reccehq.com/collaboration/share.md): share validation results securely with reviewers and stakeholders

## Reference

- [Configuration](https://docs.reccehq.com/technical-concepts/configuration.md): recce.yml reference for preset checks and parameters
- [State File](https://docs.reccehq.com/technical-concepts/state-file.md): state file format for validation results, checks, and environment info