Initial dotfiles repo for Mac and Linux

ai-instructions/README.md

@@ -0,0 +1,28 @@
+# 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`