Rules Overview
The .agent/rules/ directory is the single source of truth for all development standards in this repository. Every AI IDE (Cursor, Windsurf, Claude, Copilot, etc.) reads from the same rule files, ensuring consistent behavior across all AI coding assistants.
Rule Files
| File | Scope |
|---|---|
| 01 · General | Language, communication, core principles |
| 02 · Coding Style | Commit messages, naming, formatting |
| 03 · Architecture | Project structure, cross-platform design |
| 04 · Security | Secrets, auth, input validation |
| 05 · Dependencies | Version pinning, lock files, auditing |
| 06 · CI & Testing | Pipelines, quality gates, test strategy |
| 07 · Git | Branch strategy, PR workflow, atomic commits |
| 08 · Dev Env | Local setup, DevContainer, tooling |
| 09 · AI Interaction | AI agent behavior and boundaries |
| 10 · UI/UX | Frontend, accessibility, i18n |
| 11 · Deployment | Docker, IaC, release pipelines |
| 12 · Docs | Documentation standards, Sync logic |
How Rules Work
Rules are loaded automatically by each AI IDE via their respective config files:
- Cursor →
.cursor/rules/(symlinks to.agent/rules/) - Windsurf →
.windsurfrules - Claude / Gemini →
CLAUDE.md/GEMINI.md(redirect to.agent/rules/) - GitHub Copilot →
.github/copilot-instructions.md - Continue →
.continue/config.json
Adding or Modifying Rules
- Edit the relevant file in
.agent/rules/ - All AI IDEs will pick up the change automatically on next session
- Commit with
docs(rules): <description>
Single Source of Truth: Never edit IDE-specific rule files directly. Always update
.agent/rules/and let the symlinks/redirects propagate the change.