Claude Starter Kit

Production-ready Claude Code configuration. Start minimal, scale as needed.

Installation

git clone https://github.com/raintree-technology/claude-starter
cd /path/to/your/project
/path/to/claude-starter/setup.sh --interactive

Presets (6 available in .claude/presets/):

./setup.sh --preset nextjs-full      # Next.js full stack
./setup.sh --preset fullstack-saas   # Next.js + Stripe + Supabase + DevOps
./setup.sh --preset minimal          # Core components only
./setup.sh --preset react-focused    # React development
./setup.sh --preset stripe-commerce  # E-commerce with Stripe
./setup.sh --preset devops-complete  # DevOps automation
./setup.sh --help                    # All options

Validate setup:

./quick-validate.sh                  # Verify configuration works

Manual:

cp -r /path/to/claude-starter/.claude /path/to/your/project/

What's Included

Core (Always Active)

• 3 agents: Security auditor, database architect, API builder
• 9 commands: /build-safe, /commit, /create-pr, /release, /sync-types, /db-migrate, /health-check, /enable-hook, /self-test

Optional (60+ Features) - Full catalog

• Frameworks: Next.js (9), React (2), Bun (5)
• Integrations: Stripe (5), Supabase (1), D3 (5), Shelby (4), Resend (1)
• Tools: 6 agents, 10 hooks, 7 commands
• Meta: Skill builder, MCP optimization, TOON format, Complextropy QC

Structure

.claude/
├── core/              # Active by default
│   ├── agents/        # Security, database, API
│   └── commands/      # Build, git, validation
├── examples/          # Copy as needed
│   ├── skills/        # Framework expertise
│   ├── hooks/         # Quality automation
│   └── agents/        # Specialized helpers
└── settings.json      # Minimal config

Token Optimization

MCP Optimization: 98%+ reduction (150K → 2K tokens)

• Anthropic Engineering Blog
• Progressive tool loading, context-efficient filtering, privacy-preserving workflows

TOON Format: 40-60% reduction for structured data

• Schema hoisting (declare once, not per row)
• Minimal syntax, streaming support for 10K+ records
• Documentation

Automation & Quality

Git Workflows:

• /commit - Conventional commits from staged changes
• /create-pr - Auto-generate PR with labels, issue links
• /release - Semantic versioning, changelog, npm publishing
• 3 CI/CD workflows included

Quality Automation:

• Component size validation (agents <500 lines, skills <900 lines, commands <250 lines)
• 10 optional hooks for code quality, security, accessibility
• /enable-hook command for easy activation

Complete guide

Notable Features

Advanced Agent Systems:

• Chief of Staff - Multi-agent system with financial analyst, recruiter, and strategic planning
• Research Agent - Hierarchical research with lead/subagent coordination
• Skill Builder - Meta-skill for creating new skills with templates and validation

Framework Expertise:

• Next.js 16 Audit - Automated migration and best practices validation
• Streaming Architect - React Suspense and streaming patterns
• Form Actions - Server actions and progressive enhancement

Developer Tools:

• MCP Optimization - 98%+ token reduction patterns
• Complextropy - Code complexity metrics and quality scoring
• TOON Format - 40-60% reduction for structured data

Documentation

• Quick Start
• Customization
• Feature Catalog
• Contributing
• Optimization Guide

Requirements

• Claude Code >= 0.8.0
• Node.js >= 18 (for hooks)

License

MIT - See LICENSE

Support

• GitHub Issues
• Documentation