# R3

> Research, Reviews, Recommendations - A headless content platform delivering unbiased, research-backed product recommendations for conscious families. Built with Next.js, Supabase, and Stripe.

For comprehensive documentation with full inline content, see [llms-full.txt](llms-full.txt).

R3 positions itself as "The Wirecutter for Clean Parenting," using AI-powered dynamic scoring methodology that adapts to each product type's unique characteristics. The platform features a freemium model with premium content gating, affiliate integrations, and an intelligent methodology generation system.

## Documentation

- [README](README.md): Project overview, tech stack, installation, and quick start guide
- [Claude Instructions](CLAUDE.md): AI assistant integration guidelines and development patterns
- [Agent Guidelines](AGENTS.md): Autonomous agent operation principles and orchestration rules
- [Business Context](BUSINESS.md): Brand guidelines, target audience, revenue model, and growth strategy

## Architecture

- [Architecture Reference](docs/CLAUDE_ARCHITECTURE.md): Authentication flow, payment integration, content gating, and key implementation patterns
- [Development Patterns](docs/CLAUDE_PATTERNS.md): Common gotchas, image pipeline, and troubleshooting guides
- [Skills Reference](docs/CLAUDE_SKILLS.md): Available AI skills and decision tree for skill selection
- [Dynamic Methodology](docs/DYNAMIC_METHODOLOGY_ARCHITECTURE.md): Intelligent scoring system that adapts to product types
- [Paywall Architecture](docs/SEO_PAYWALL_ARCHITECTURE.md): SEO-preserving soft-gating with tiered access control
- [Research Journey](docs/research-journey-architecture.md): User research flow and content organization

## Business & Strategy

- [Affiliate Strategy](docs/AFFILIATE_STRATEGY.md): Revenue strategy and affiliate program integrations
- [E-commerce Strategy](docs/ECOMMERCE_STRATEGY.md): Growth phases from subscriptions to marketplace
- [SEO Operations](docs/SEO_OPERATIONS_CHECKLIST.md): Search optimization checklist and practices
- [Brand Voice Guide](brand-guidelines/templates/quick-reference.md): Tone, voice attributes, and writing guidelines

## Guides

- [Setup Guide](docs/guides/SETUP_GUIDE.md): Initial project setup and configuration
- [Admin Workflow](docs/guides/ADMIN_WORKFLOW.md): Managing products and content administration
- [Deployment Guide](docs/DEPLOYMENT.md): Production deployment instructions

## Configuration

- [Environment Example](.env.example): Required environment variables template
- [Package Configuration](package.json): Dependencies and available scripts
- [TypeScript Config](tsconfig.json): TypeScript compiler settings
- [Next.js Config](next.config.ts): Framework configuration and optimizations

## Database

- [Supabase Config](docs/SUPABASE_CONFIG.md): Database setup and configuration
- [Migrations](supabase/migrations/): Database schema migrations directory

## Optional

- [Product Orchestrator](.claude/skills/product-orchestrator/README.md): AI skill for adding complete product categories
- [PRD](prd.md): Full product requirements document
- [Orchestration Integration](docs/ORCHESTRATION_INTEGRATION.md): AI agent team coordination patterns
- [Enrichment Pipeline](docs/ENRICHMENT_PIPELINE.md): Product data enrichment workflow