Cursor rule

1---
2description: Agent Files
3globs: 
4  - ".claude/**"
5  - ".cursor/**"
6  - ".codex/**"
7  - ".github/copilot-instructions.md"
8alwaysApply: false
9---
10 
11 
12# Agent Files
13 
14This rule applies when editing `.claude/`, `.cursor/`, `.codex/`, or `.github/copilot-instructions.md`.
15 
16## Single Source of Truth (SSOT) Design
17 
18AI Agent configuration files are managed with **Claude Code's `.claude/` directory as the single source**. Other agent configurations are auto-generated or symlinked.
19 
20```
21.claude/                    ← SSOT (Source of Truth)
22├── commands/               ← Slash commands
23├── rules/                  ← Rules (*.md)
24└── skills/                 ← Skills (SKILL.md)
25 
26.cursor/                    ← Auto-generated / Symlinked
27├── commands/README.md      ← Reference only (uses .claude/commands)
28├── rules/*.mdc             ← Auto-generated (make sync-cursor-rules)
29└── skills/                 ← Symlink → ../.claude/skills
30 
31.codex/                     ← TODO (Future support)
32.github/copilot-instructions.md ← TODO (Future support)
33```
34 
35## Supported AI Agents
36 
37| Agent | Version | Status | Config Location |
38|-------|---------|--------|-----------------|
39| Claude Code | v2 | ✅ Active | `.claude/` (SSOT) |
40| Cursor | v2 | ✅ Active | `.cursor/` (Auto-generated) |
41| Codex | v0.80 | 📋 TODO | `.codex/` |
42| GitHub Copilot | 2026 | 📋 TODO | `.github/copilot-instructions.md` |
43 
44## File Reference Format
45 
46### Claude Code
47 
48```markdown
49- Follow @AGENTS.md for guidelines
50- Refer to @docs/guidelines/coding-conventions.md
51```
52 
53### Cursor
54 
55Supports the same `@path` format. No conversion needed.
56 
57## Directory-Specific Rules
58 
59### `.claude/commands/`
60 
61Location for slash command definitions. Automatically loaded by Cursor as well.
62 
63**Editing Notes:**
64 
65- Create new commands in `.claude/commands/`
66- Only place README.md in `.cursor/commands/`
67 
68### `.claude/rules/`
69 
70Rule files for Claude Code (`.md`).
71 
72**Format:**
73 
74```markdown
75---
76paths:
77  - "**/*.go"
78  - "**/*.ts"
79---
80 
81# Rule Title
82 
83Rule content...
84```
85 
86- Without `paths:` → Applies to all instructions (global rule)
87- With `paths:` → Applies when editing files matching the specified patterns
88 
89### `.claude/skills/`
90 
91Location for Skills (MCP) definitions. Each skill has `SKILL.md` in its subdirectory.
92 
93```
94.claude/skills/
95├── go-development/SKILL.md
96├── git-workflow/SKILL.md
97└── db-migration/SKILL.md
98```
99 
100### `.cursor/rules/`
101 
102**Auto-generated files - DO NOT EDIT DIRECTLY**
103 
104Auto-generated from Claude rules. Conversion rules:
105 
106| Claude | Cursor |
107|--------|--------|
108| No `paths:` | `alwaysApply: true` |
109| Has `paths:` | `globs:` + `alwaysApply: false` |
110| First `# Heading` | `description:` |
111| `.md` | `.mdc` |
112 
113**Sync Command:**
114 
115```bash
116make sync-cursor-rules
117```
118 
119> **IMPORTANT**: After modifying any files in `.claude/rules/`, you MUST run `make sync-cursor-rules` to synchronize with `.cursor/rules/`. This ensures both Claude Code and Cursor use the same rules.
120 
121## Model Context Protocol (MCP) / Skills
122 
123MCP, proposed since late 2024, is now widespread as of 2026. AI Agents can use repository scripts and local servers as "Skills".
124 
125### Claude Code / Cursor
126 
127Place `SKILL.md` in `.claude/skills/` or `.cursor/skills/`.
128 
129### Codex (Future Support)
130 
131For CLI-based Codex agent, Shell/Python scripts are expected to be bound as Skills and invoked like `@database_tool`.
132 
133## Editing Checklist
134 
135When editing `.claude/` or `.cursor/`:
136 
137- [ ] Make changes to `.claude/` (SSOT)
138- [ ] Do NOT edit `.cursor/rules/` directly
139- [ ] **Run `make sync-cursor-rules` after modifying `.claude/rules/`** (Required)
140- [ ] Check if README.md needs updating
141 
142## Related Documents
143 
144- @.cursor/rules/README.md - Cursor rules specification
145- @.cursor/commands/README.md - Commands description
146- @AGENTS.md - Project-wide guidelines
147