Skip to content

docs: Broader introduction - problem, solution, strengths#90

Draft
ijac13 wants to merge 1 commit intomainfrom
docs/broader-introduction
Draft

docs: Broader introduction - problem, solution, strengths#90
ijac13 wants to merge 1 commit intomainfrom
docs/broader-introduction

Conversation

@ijac13
Copy link
Contributor

@ijac13 ijac13 commented Mar 12, 2026

Summary

Restructure the landing page to better communicate what Recce is and why it matters.

Changes

1. Problem/Value (why Recce exists)

  • Data pipelines succeed but data is quietly wrong
  • PRs merge without checking what actually changed in the data
  • Validation knowledge stays in people's heads instead of becoming team practice
  • Junior and senior engineers apply different standards

2. Solution (what Recce is)

Core: Validation engine that compares base vs. current environments and visualizes differences.

Access via:

Method Description
Cloud Hosted service with automated PR validation
OSS Self-hosted validation engine
CLI Command-line interface for local and CI/CD
Agent AI-powered reviewer that analyzes changes
Plugin Claude Code plugin for guided setup
MCP Model Context Protocol for AI agents

3. What Makes Recce Different (strengths)

  • Column-level impact radius: Validate only affected columns, not entire models. Key differentiator.
  • Agent as reviewer zero: Agent does validation, surfaces unknown unknowns. Users focus on judgment.
  • Collaborate and standardize: Individual checks → team standards (preset checks)

Test Plan

  • mkdocs build succeeds
  • Review content accuracy
  • Verify links work

🤖 Generated with Claude Code

@ijac13 ijac13 marked this pull request as draft March 12, 2026 01:38
@ijac13 ijac13 force-pushed the docs/broader-introduction branch 7 times, most recently from 647dfb0 to d83451b Compare March 12, 2026 01:54
Restructure the landing page to better communicate:

1. Problem/Value
   - Data pipelines succeed but data is quietly wrong
   - Validation knowledge stays in people's heads
   - Jr/Sr engineers apply different standards

2. Solution
   - Core: validation engine + visualization
   - Access via: Cloud, OSS, CLI, Agent, Plugin, MCP

3. What Makes Recce Different
   - Column-level impact radius: validate affected columns, not entire models
   - Agent as reviewer zero: surfaces unknown unknowns, users focus on judgment
   - Collaborate and standardize: checks → preset checks

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@ijac13 ijac13 force-pushed the docs/broader-introduction branch from d83451b to 2d97fbd Compare March 12, 2026 01:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant