# 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`