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.
- Unity 6.2 or higher
- IDE: Cursor IDE OR Google Antigravity Workspace
- .NET SDK for C# development
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
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.
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.
MIT License - see LICENSE