Commit c7c0b76
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
0 commit comments