Skip to content

Commit c7c0b76

Browse files
PaulJPhilpclaude
andcommitted
docs: Comprehensive CLAUDE.md improvements - architecture, commands, and patterns
Enhanced CLAUDE.md from 147 to 502 lines with major improvements: High-Level Architecture: - Workspace structure explanation (npm workspaces, no path aliases) - MCP server architecture with dependency flow diagram - Key architecture patterns: Effect.Service, error-as-values, layered composition Development Commands: - Building & installation (bun install, bun run build, typecheck, lint) - MCP server development (mcp:dev, mcp:build) - 870+ tests: unit, routes, mcp, integration, deployment, stress - Publishing pipeline (validate, generate, ingest) - Database operations (migrations, schema changes) - QA workflow (process, report, repair) Key Architecture Patterns: - Effect.Service pattern with examples - Error handling as values (tagged errors) - Layered service composition (Layer.mergeAll) - Database with Drizzle ORM - Configuration patterns and environment variables Important Files & Purposes: - MCP server core (init, stdio, tools, errorHandler, routeHandler) - 8 critical services (config, cache, circuit-breaker, rate-limit, review-code, logger, metrics) - Database schema and client - Error handling and configuration Database Schema: - effect_patterns, application_patterns, pattern_jobs, pattern_relations - Skill levels (beginner, intermediate, advanced) - Indexes and JSONB fields for flexibility Service Configuration: - Resilience settings (circuit breaker, rate limiting, caching) - Environment variables reference - MCP-specific config Common Development Tasks: - Running single test files with proper config - Debugging services - Schema changes workflow - Adding analysis rules Package Resolution: - Workspace:* dependencies (not TypeScript path aliases) - Independent tsconfig per package Removed outdated/redundant content while expanding on critical architecture details. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
1 parent 7de189c commit c7c0b76

1 file changed

Lines changed: 435 additions & 127 deletions

File tree

0 commit comments

Comments
 (0)