ai-agent-unity-rules
Common-ka · Common-ka/ai-agent-unity-rules
Provides production-ready AI configuration rules for Unity 6.2+ projects, universally supporting Cursor IDE and Google Antigravity with an auto-sync workflow.
🎮 Production-ready AI rules for Unity 6.2+. Single Source of Truth for Cursor (.cursor) and Google Antigravity (.agent) with auto-sync workflow.
Preview
What you can do with it
- Implement consistent AI coding standards across Unity projects using Cursor.
- Synchronize AI agent rules between Cursor and Google Antigravity automatically.
- Leverage AI for C# game development with predefined best practices.
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
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:
- Cursor IDE (via native
.mdcformat) - Google Antigravity (via synced
.agent/rulesformat)
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.
cd YourUnityProject
git clone https://github.com/Common-ka/ai-agent-unity-rules.git
Option B: Manual Setup
For Cursor Users:
- Copy the
.cursor/folder to your project root. - Copy
.vscode/settings.jsonto your project's.vscode/folder.
For Antigravity Users:
- Copy the
.agent/folder to your project root. - Ensure
.agent/rules/contains the.mdfiles.
🛠 How it Works (Sync Workflow)
This repository uses a Uni-Directional Data Flow to keep rules in sync.
graph LR
A[.cursor/rules/*.mdc] -- python script --> B(.agent/rules/*.md)
- Source: Rules are authored in
.cursor/rules/using the modern.mdcformat. - Sync: A Python script (
sync_rules.py) automatically converts these files into standard Markdown for Antigravity. - Automation: A GitHub Action runs on every push to ensure
.agent/rulesare always up to date.
📄 License
MIT License - see LICENSE