Claude Code Configs

repository·main·Indexed 20 days ago

https://github.com/matt-dionis/claude-code-configs

A CLI tool and registry for generating production-ready Claude Code configurations. It provides tailored setups for frameworks like Next.js 15, UI libraries such as shadcn/ui and Tailwind CSS, databases like Drizzle ORM, and various MCP servers. The composer features a smart merging engine to combine multiple configurations into a unified development environment, creating the necessary .claude/ directory and CLAUDE.md file.

Tokens
28.9K
Snippets
81
Records
119
Agent score
70%

What's inside claude-config-composer

  1. Overview of Token-Gated MCP Server Configuration

    main

    This configuration is designed for building token-gated Model Context Protocol (MCP) servers, specifically optimized for the decentralized AI tool marketplace. It is built for use with FastMCP 3.0+ and the Radius MCP SDK 1.0+.

    Key capabilities include:

    • 3-Line Integration: Token-gate any tool with minimal code.
    • AI-Friendly Errors: Automatically guides Claude through authentication processes.
    • Security First: Includes automatic detection of private keys and unsafe patterns.
    • Production Ready: Features built-in safety checks and deployment tools.

    This configuration is ideal for implementing ERC-1155 token access control, creating tiered access models for AI tools, or deploying to the Radius Network (testnet and mainnet).

  2. Overview of shadcn/ui Claude Code Configuration

    main

    The shadcn-claude-config provides a specialized development environment for building React applications using shadcn/ui. It transforms Claude Code into a UI expert by providing specialized agents, power commands, and automation hooks designed to follow shadcn/ui best practices.

    Key Capabilities

    • Component Generation: Creates components following specific shadcn/ui patterns.
    • Accessibility Compliance: Includes built-in WCAG 2.1 AA validation.
    • Performance Optimization: Automates bundle and runtime optimizations.
    • Framework Support: Compatible with Next.js, Vite, Remix, Astro, and more.
    • Theme Management: Provides a complete system for dark mode and theming.

    Compatibility

    • Configuration Version: 1.0.0
    • shadcn/ui: 0.8+
    • React: 18+
    • Tailwind CSS: 3.4+
  3. Overview of Specialized AI Agents in this configuration

    main

    When working with this configuration, Claude Code assumes the persona of several specialized agents depending on your task:

    • RAG Developer: Expert in embeddings, vector databases, and semantic search for knowledge bases and Q&A systems.
    • Multi-Modal Expert: Expert in image/PDF processing, file uploads, and visual AI.
    • Streaming Expert: Expert in real-time responses, chat interfaces, and progressive enhancement.
    • Tool Integration Specialist: Expert in function calling, external APIs, and agentic workflows.
    • Provider Configuration Expert: Expert in multi-provider setup, cost management, and reliability/performance optimization.
  4. Understand the generated Claude Code structure

    main

    When you run the composer, it generates a specific directory structure designed for Claude Code. It does not modify your README.md or package.json files.

    Generated files include:

    • CLAUDE.md: A combined documentation file containing instructions, patterns, and commands.
    • .claude/settings.json: Merged configuration settings.
    • .claude/agents/: Framework-specific agent definitions.
    • .claude/commands/: Custom commands for the Claude interface.
    • .claude/hooks/: Development hooks.
  5. Use specialized agents for token-gated development

    main

    The configuration includes 5 expert agents designed to assist with specific tasks in the token-gated MCP ecosystem:

    • radius-sdk-expert: Expert in Radius MCP SDK implementation, token protection, and proof verification.
    • fastmcp-builder: Specialist in FastMCP server development (tools, resources, prompts, and transport).
    • auth-flow-debugger: Expert in debugging authentication flows, including EVMAUTH errors and proof validation.
    • token-economics-designer: Specialist in designing pricing models, access tiers, and token distribution.
    • web3-security-auditor: Web3 security expert for smart contract safety and cryptographic operations.
  6. Implement Dark Mode with Class-Based Theming

    main

    To implement dark mode, set darkMode: 'class' in your tailwind.config.js. You can then toggle the dark class on the document.documentElement. Use the dark: variant in your utility classes to define styles for dark mode. For advanced theming, define CSS variables in a @layer base block within your CSS file to swap color values when the .dark class is present.

    /* globals.css */
    @tailwind base;
    @tailwind components;
    @tailwind utilities;
    
    @layer base {
      :root {
        --background: 0 0% 100%;
        --foreground: 222.2 84% 4.9%;
        --primary: 221.2 83.2% 53.3%;
        --primary-foreground: 210 40% 98%;
      }
      
      .dark {
        --background: 222.2 84% 4.9%;
        --foreground: 210 40% 98%;
        --primary: 217.2 91.2% 59.8%;
        --primary-foreground: 222.2 84% 4.9%;
      }
    }
  7. How specialized AI agents work in shadcn/ui config

    main

    The configuration utilizes 10 specialized sub-agents to handle specific domains of UI development. When you prompt Claude, it can leverage these expert personas to ensure high-quality output.

    Core Development Agents

    • component-builder: Specialist in component creation, TypeScript types, and variant systems.
    • accessibility-auditor: Expert in ARIA, keyboard navigation, and screen reader support.
    • tailwind-optimizer: Specialist in utility classes and responsive design.
    • radix-expert: Expert in Radix UI primitives and composition.
    • form-specialist: Expert in React Hook Form and Zod validation.

    Advanced Feature Agents

    • data-display-expert: Specialist in TanStack Table and Recharts.
    • theme-designer: Expert in CSS variables and color systems.
    • animation-specialist: Expert in Framer Motion and CSS transitions.
    • migration-expert: Specialist in converting existing components to shadcn patterns.
    • performance-optimizer: Expert in bundle size and lazy loading.
  8. Use specialized Next.js 15 agents

    main

    The configuration includes 11 specialized AI agents designed for specific Next.js development tasks. You can invoke them by name to focus Claude's expertise on a particular domain.

    Core Development Agents

    • nextjs-app-router: Expert in App Router (pages, layouts, dynamic/parallel routes).
    • nextjs-server-components: Specialist in component boundaries and hydration issues.
    • nextjs-server-actions: Expert in forms, mutations, and progressive enhancement.
    • nextjs-data-fetching: Specialist in fetch strategies, caching, and streaming.
    • nextjs-performance: Expert in bundle analysis and Core Web Vitals.

    Infrastructure & Testing Agents

    • nextjs-testing: Specialist in Jest, Vitest, Playwright, and Cypress.
    • nextjs-deployment: Expert in Docker, Vercel, AWS, and CI/CD.
    • nextjs-migration: Specialist in Pages → App Router migrations.
    • nextjs-security: Expert in Authentication, CSP, and validation.
    • nextjs-debugging: Specialist in React DevTools and error resolution.
    • nextjs-typescript: Expert in type-safe patterns and error fixing.
  9. Tailwind CSS Integration Compatibility

    main

    The Tailwind CSS Claude Code configuration is designed to work seamlessly with the following technologies:

    • Next.js 15 (App Router and Server Components)
    • React/Vue/Svelte (Component-based architectures)
    • shadcn/ui (Pre-built accessible components)
    • Headless UI (Unstyled, accessible UI primitives)
    • Framer Motion (Animation library integration)
    • Storybook (Component documentation and testing)
  10. How Claude Config Composer merges configurations

    main

    The composer uses a registry system and a smart merging engine to combine multiple configurations without duplication or conflict.

    Merging Logic

    1. Registry System: Uses metadata to manage dependencies, conflicts, and section priorities.
    2. Smart Merging: Parses markdown structures and identifies duplicate sections. It merges compatible content (like commands) while preserving framework-critical sections.
    3. Conflict Resolution: Detects incompatible configurations, suggests missing dependencies, and allows overrides with warnings.

    Section Handling

    Sections are ordered by priority (higher values first):

    • Priority 15: Critical/Breaking changes (Non-mergeable; preserved from highest priority config).
    • Priority 10: Core principles (Non-mergeable; preserved from highest priority config).
    • Priority 5: Common commands (Mergeable; content from multiple configs is combined).

    Mergeable Sections include: Common Commands, Security Best Practices, Testing Approaches, and Performance Optimization. Non-Mergeable Sections include: Breaking Changes, Critical Principles, and Framework-specific conventions.

  11. Use specialized MCP agents

    main

    The configuration includes 6 specialized agents to assist with different stages of MCP development:

    Core MCP Development

    • mcp-architect: Expert in server architecture, capability design, and protocol patterns.
    • tool-builder: Specialist in creating tools, parameter schemas, and response formats.
    • resource-manager: Expert in URI schemes, content types, and dynamic resources.

    Development & Operations

    • error-handler: Assists with error codes, validation, and troubleshooting.
    • test-writer: Expert in unit tests, integration tests, and MCP Inspector usage.
    • deployment-expert: Assists with Docker, npm publishing, and Claude integration.
  12. Use specialized agents for MCP and Memory development

    main

    This configuration provides 15 specialized agents categorized by domain to assist with specific development tasks:

    MCP Protocol Experts

    • mcp-protocol-expert: Protocol debugging and compliance.
    • mcp-sdk-builder: SDK implementation patterns.
    • mcp-transport-expert: Transport layers (stdio, HTTP, SSE).
    • mcp-types-expert: TypeScript and Zod schemas.
    • neon-drizzle-expert: Neon PostgreSQL with Drizzle ORM.
    • pgvector-advanced: Advanced pgvector v0.8.0 features.
    • vector-search-expert: Semantic search and embeddings.

    Memory & Architecture

    • memory-architecture: Database design and indexing.
    • memory-lifecycle: Consolidation and expiration.
    • memory-validator: Data integrity and validation.
    • companion-architecture: Multi-tenant AI systems.

    Development & Operations

    • code-reviewer: Security-focused code review.
    • debugger: Systematic debugging.
    • test-runner: Automated testing.
    • production-deployment: HTTPS deployment and containerization.