dotfiles/ai-instructions/README.md

AI Instructions / Rules System

This directory contains single-source-of-truth instructions that are shared between Claude Code and Cursor IDE.

How It Works

ai-instructions/*.md  (SOURCE OF TRUTH)
    ↓
    ├──> claude/.claude/rules/*.md  (symlinks for Claude Code)
    └──> cursor/.cursor/rules/*.md  (symlinks for Cursor IDE)

During Installation

When you run install.sh (or when a Coder devbox starts):

1. Directories created: claude/.claude/rules and cursor/.cursor/rules are created.
2. Rules generated: The generate_rules function in install.sh symlinks ai-instructions/*.md → claude/.claude/rules/*.md and cursor/.cursor/rules/*.md.
3. Stow creates symlinks:
   • claude/.claude/* → ~/.claude/*
   • cursor/.cursor/* → ~/.cursor/*

Result

Both IDEs load the same instructions:

• Claude Code: Reads ~/.claude/CLAUDE.md + ~/.claude/rules/*.md
• Cursor IDE: Reads ~/.cursor/rules/*.md