|
WE3 builds products and companies with senior Product, Design, and Engineering teams. This repository is part of our open-source community offerings. Start your brief. |
A unified reference for AI coding assistant rules, guidelines, and best practices across multiple tools.
What this is · Who this is for · Supported Tools · Repository Layout · Where to Start · Quality · Related
Canonical rules and best practices for AI coding assistants (Cursor, Claude Code, Codex, Gemini CLI, Antigravity), derived from AI Blindspots. Each tool gets the same principles translated into its configuration format.
- Developers using AI coding assistants in their workflow
- Teams adopting shared rules for AI-assisted development
- Maintainers of projects that rely on AI pair programming
- Cursor — Cursor IDE
- Claude Code — Claude Code
- Codex — Codex
- Gemini CLI — Gemini CLI
- Antigravity — Antigravity
Install using the setup script (interactive or flag-based):
python scripts/setup-rules.py # interactive
python scripts/setup-rules.py --tool cursor --project .Or use the direct install script:
python scripts/install-implementation.py cursor . # install Cursor rules to current dir
python scripts/install-implementation.py claude /path/to/project # install Claude rules to target
python scripts/install-implementation.py # list available tools (no args)See implementations/README.md#installation for options and examples.
ai-assistant-rules/
├── ai-blindspots/ # Canonical rules & articles (Edward Z. Yang)
│ ├── articles/ # In-depth articles by topic
│ ├── rules/ # Comprehensive AI coding assistant rules
│ ├── QUICK_REFERENCE.md
│ └── TOOL_TRANSLATION_GUIDE.md
│
├── assets/ # Images (logos, diagrams)
├── backlog/
│ ├── active/ # Work items (phases: Now, Next, Later)
│ └── done/ # Completed work items
│
├── docs/ # User-facing documentation
├── implementations/ # Tool-specific rule configurations
│ ├── cursor/ # Cursor IDE rules
│ ├── claude/ # Claude Code rules
│ ├── codex/ # Codex rules
│ ├── gemini/ # Gemini CLI rules
│ └── antigravity/ # Antigravity rules
│
└── scripts/ # Install and maintenance scripts
├── install-implementation.py
└── setup-rules.py
Relationship: All implementations derive from ai-blindspots. Each tool folder contains the same principles translated into that tool's configuration format. See implementations/README.md for details.
| Goal | Start Here |
|---|---|
| Quick cheat sheet | ai-blindspots/QUICK_REFERENCE.md (5 min) |
| Full ruleset | ai-blindspots/rules/ai-coding-assistant-rules.md (30 min) |
| Set up a new Cursor project | implementations/cursor/README.md |
| Install an implementation | implementations/README.md#installation |
| Browse tool implementations | implementations/README.md |
| Adapt rules for other tools | ai-blindspots/TOOL_TRANSLATION_GUIDE.md (Claude, Codex, Gemini, Antigravity) |
| Deep dive on a topic | ai-blindspots/articles/ |
CI workflows run on pull requests:
- Docs QA — Markdown lint, link checks, required sections
- Parity check — Canonical-to-tool coverage
- Staleness check — Sunset tracking
- Source: ezyang.github.io/ai-blindspots — Edward Z. Yang's original AI Blindspots collection
- Lightweight AI Development Agent Skills: WE3io/lightweight-ai-development-agent-skills — A small set of reusable AI agent skills (Work Item Designer, Implementation Executor, Decision Lens, Documentation Lens, Safety Lens) for disciplined, low-ceremony development. Use it alongside these rules for comprehensive guidance across tools.