๋ณธ๋ฌธ์œผ๋กœ ๊ฑด๋„ˆ๋›ฐ๊ธฐ
TakoAPI
์Šคํ‚ฌ๋กœ ๋Œ์•„๊ฐ€๊ธฐ
โ€”์•„์ง ํ‰๊ฐ€ ์—†์Œ
๋‚ด ํ‰๊ฐ€

์š”์•ฝ

๐ŸŽฎ Production-ready AI rules for Unity 6.2+. Single Source of Truth for Cursor (.cursor) and Google Antigravity (.agent) with auto-sync workflow.

์„ค๋ช…

[![Release](https://img.shields.io/github/v/release/Common-ka/ai-agent-unity-rules)](https://github.com/Common-ka/ai-agent-unity-rules/releases)

# Unity AI Agent Rules (Cursor + Antigravity)

## ๐Ÿ“‹ Description

**The Single Source of Truth for Unity AI assistance.**

This repository provides production-ready configuration rules for Unity 6.2+ projects. It is designed to be **universal**, automatically supporting both:
1.  **Cursor IDE** (via native `.mdc` format)
2.  **Google Antigravity** (via synced `.agent/rules` format)

We use a "write once, deploy everywhere" approach: rules are defined in Cursor's format and automatically converted for Antigravity Workspace using a custom CI/CD workflow.

## ๐Ÿš€ Quick Start

### Requirements

- Unity 6.2 or higher
- **IDE:** Cursor IDE *OR* Google Antigravity Workspace
- .NET SDK for C# development

### Installation

#### Option A: Automatic Setup (Recommended)
Simply clone this repository into the root of your Unity project. The AI agents will automatically detect their respective configuration folders.

```bash
cd YourUnityProject
git clone https://github.com/Common-ka/ai-agent-unity-rules.git

```

#### Option B: Manual Setup

**For Cursor Users:**

1. Copy the `.cursor/` folder to your project root.
2. Copy `.vscode/settings.json` to your project's `.vscode/` folder.

**For Antigravity Users:**

1. Copy the `.agent/` folder to your project root.
2. Ensure `.agent/rules/` contains the `.md` files.

---

## ๐Ÿ›  How it Works (Sync Workflow)

This repository uses a **Uni-Directional Data Flow** to keep rules in sync.

```mermaid
graph LR
    A[.cursor/rules/*.mdc] -- python script --> B(.agent/rules/*.md)

```

1. **Source:** Rules are authored in `.cursor/rules/` using the modern `.mdc` format.
2. **Sync:** A Python script (`sync_rules.py`) automatically converts these files into standard Markdown for Antigravity.
3. **Automation:** A GitHub Action runs on every push to ensure `.agent/rules` are always up to date.


## ๐Ÿ“„ License

MIT License - see [LICENSE](https://www.google.com/search?q=LICENSE)

์„ค์น˜

https://github.com/Common-ka/ai-agent-unity-rules์—์„œ ์Šคํ‚ฌ์„ ์„ค์น˜ํ•ด์ค˜

์ด ์Šคํ‚ฌ์€ ClawHub ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ์— ๊ฒŒ์‹œ๋˜์ง€ ์•Š์•˜์Šต๋‹ˆ๋‹ค. ํ”„๋กฌํ”„ํŠธ๋ฅผ ์ฝ”๋”ฉ ์—์ด์ „ํŠธ(Claude Code, Cursor, Codex)์— ๋ถ™์—ฌ๋„ฃ์œผ๋ฉด ์†Œ์Šค ์ €์žฅ์†Œ์—์„œ ๋ฐ”๋กœ ์Šคํ‚ฌ์„ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค.

์ €์žฅ์†Œ ์—ด๊ธฐ

๋งํฌ