AI Configuration

This directory contains unified configuration for AI development tools (Claude, Cursor, GitHub Copilot) used in this repository.

Structure

• config/ - Shared and tool-specific configuration files
  • shared/ - Instructions and guidelines shared across all AI tools
  • mcp/ - Model Context Protocol (MCP) server configurations
  • tools/ - Tool-specific configuration overrides
• agents/ - Reusable agent definitions for specialized tasks
• skills/ - Reusable workflow skills and commands
• thoughts/ - Output artifacts from AI-assisted work (research, plans, sessions)

Quick Start

For Claude Code Users

Claude automatically reads from .claude/settings.local.json which references this directory.

For Cursor Users

Cursor reads .cursorrules which includes instructions from .ai/config/shared/.

For GitHub Copilot Users

Copilot reads .github/copilot-instructions.md which references .ai/config/shared/instructions.md.

For MCP Configuration

All tools share MCP configuration from .ai/config/mcp/mcp.json.

Documentation

• Shared Instructions - Common coding guidelines
• Workspace Overview - Project architecture and commands
• Contributing Guidelines - Commit conventions and workflow
• MCP Setup - MCP server configuration guide
• Agents Guide - Using and creating agents
• Skills Guide - Available workflow skills

Adding New AI Tools

To add support for a new AI tool:

1. Create tool-specific config in config/tools/{tool-name}.md
2. Configure tool to read from config/shared/ for common instructions
3. Reference MCPs from config/mcp/mcp.json
4. Document tool-specific setup in this README