Voltar às skills
vibe-coding-ai-rules
por obviousworks
Windsurf—Ainda sem avaliações
Sua avaliação
Resumo
The Ultimate Agentic Vibe Coding Guide for AI IDEs like Windsurf, Claude Code, Cursor, Codex etc. – AI-optimized rules, best practices, and configuration files for efficient and controlled AI-powered coding.
Descrição
# Vibe Coding AI Rules
**The Ultimate AI Coding Ruleset for Windsurf, Cursor, GitHub Copilot, Claude Code, Cline, Codex, Zed AI, Gemini CLI & more**
> "Context is King. AI agents are only as good as the rules you give them."
[](https://opensource.org/licenses/MIT)
[](http://makeapullrequest.com)
Production-ready rules, templates, and best practices for AI-assisted development. One repository, all major AI IDEs covered.
---
## Quick Start: Pick Your IDE
| AI IDE | What to Copy | Config Format | Setup Guide |
|--------|-------------|---------------|-------------|
| **Cursor** | `ide-specific/cursor/` | `.cursor/rules/*.mdc` | [Setup](ide-specific/cursor/README.md) |
| **Windsurf** | `ide-specific/windsurf/` | `.windsurfrules` + `global_rules.md` | [Setup](ide-specific/windsurf/README.md) |
| **GitHub Copilot** | `ide-specific/github-copilot/` | `.github/copilot-instructions.md` | [Setup](ide-specific/github-copilot/README.md) |
| **Claude Code** | `ide-specific/claude-code/` | `CLAUDE.md` + `.claude/rules/` | [Setup](ide-specific/claude-code/README.md) |
| **Cline** | `ide-specific/cline/` | `.clinerules` or `.clinerules/` | [Setup](ide-specific/cline/README.md) |
| **Codex** | `ide-specific/codex/` | `AGENTS.md` | [Setup](ide-specific/codex/README.md) |
| **Zed AI** | `ide-specific/zed/` | `.rules` | [Setup](ide-specific/zed/README.md) |
| **Gemini CLI** | `ide-specific/gemini-cli/` | `GEMINI.md` | [Setup](ide-specific/gemini-cli/README.md) |
| **Aider** | `ide-specific/aider/` | `conventions.md` + `.aider.conf.yml` | [Setup](ide-specific/aider/README.md) |
| **Continue.dev** | `ide-specific/continue/` | `.continue/rules/*.md` | [Setup](ide-specific/continue/README.md) |
| **Universal** | `AGENTS.md` | Works everywhere | [Setup](templates/AGENTS.md) |
**Fastest approach**: Copy `AGENTS.md` to your project root and run `./scripts/symlink-setup.sh` to create symlinks for all IDEs at once.
## Universal: The AGENTS.md Standard
[AGENTS.md](https://agents.md) is the emerging universal standard for AI coding assistant configuration, backed by OpenAI, Google, Anthropic, Cursor, and Sourcegraph.
**One file, all IDEs:**
```bash
# Copy the template
cp templates/agent-template.md AGENTS.md
# Customize for your project, then:
./scripts/symlink-setup.sh
# Creates: .windsurfrules, .cursorrules, CLAUDE.md, .clinerules, GEMINI.md, .github/copilot-instructions.md
# Codex, Zed AI read AGENTS.md natively — no symlink needed
```
IDEs that read AGENTS.md natively: Cursor, GitHub Copilot, Cline, Codex, Zed AI, Gemini CLI, Aider.
## What's Inside
```
vibe-coding-ai-rules/
├── README.md # You are here
├── AGENTS.md # Universal standard (copy to your project)
├── LICENSE # MIT License
├── CONTRIBUTING.md # How to contribute
│
├── docs/ # Knowledge base
│ ├── best-practices.md # Comprehensive agentic coding guide
│ ├── security-rules.md # Security patterns for AI-generated code
│ ├── performance-rules.md # Performance optimization patterns
│ ├── testing-rules.md # Testing standards and patterns
│ ├── error-handling.md # Error handling patterns and standards
│ ├── logging-rules.md # Logging standards and best practices
│ ├── api-design.md # API design conventions (REST, RFC 7807)
│ ├── migration-guide.md # Migrate between IDE configurations
│ ├── vibe-coding-overview.md # Quick reference cheat sheet
│ └── ide-comparison.md # Feature comparison of all 10 IDEs
│
├── templates/ # Universal templates (tool-agnostic)
│ ├── AGENTS.md # Universal template
│ ├── agent-template.md # Customizable template with placeholders
│ └── agent-example.md # Real-world "FocusFlow" example
│
├── ide-specific/ # One folder per IDE
│ ├── windsurf/ # Windsurf config + examples
│ ├── cursor/ # Cursor .mdc rules + examples
│ ├── github-copilot/ # Copilot instructions + examples
│ ├── claude-code/ # CLAUDE.md + .claude/rules/ + examples
│ ├── cline/ # .clinerules single + multi-file + examples
│ ├── codex/ # AGENTS.md + examples
│ ├── zed/ # .rules + examples
│ ├── gemini-cli/ # GEMINI.md + examples
│ ├── aider/ # conventions.md + .aider.conf.yml
│ └── continue/ # .continue/rules/*.md
│
├── prompts/ # AI prompts for customization
│ ├── adapt-rules-prompt.txt # Generate rules for ANY IDE from project info
│ └── project-analyzer-prompt.txt # Analyze codebase and auto-generate rules
│
└── scripts/
└── symlink-setup.sh # Create IDE symlinks from AGENTS.md
```
## Deep Dives
| Topic | Description |
|-------|-------------|
| [Best Practices](docs/best-practices.md) | Context management, prompting, workflows, team collaboration |
| [Security Rules](docs/security-rules.md) | Input validation, injection prevention, auth, secrets management |
| [Performance Rules](docs/performance-rules.md) | Frontend, backend, database, caching optimization patterns |
| [Testing Rules](docs/testing-rules.md) | Test pyramid, patterns, mocking, coverage requirements |
| [IDE Comparison](docs/ide-comparison.md) | Feature matrix, cross-IDE compatibility, recommendations |
| [Migration Guide](docs/migration-guide.md) | Step-by-step migration between any two IDEs |
| [Error Handling](docs/error-handling.md) | Error types, propagation, retry patterns, error boundaries |
| [Logging Rules](docs/logging-rules.md) | Log levels, structured logging, correlation IDs, PII protection |
| [API Design](docs/api-design.md) | REST conventions, pagination, error responses (RFC 7807), rate limiting |
| [Vibe Coding Overview](docs/vibe-coding-overview.md) | One-page cheat sheet of core principles |
## Core Principles
These principles are embedded in all IDE-specific rule files:
| Principle | Description |
|-----------|-------------|
| Clarify Before Coding | Understand requirements before writing code. Ask questions when intent is unclear. No code without clear goals. |
| Simplicity First | Choose the simplest viable solution. Complex patterns need explicit justification. Readable code over clever code. |
| Security By Default | Validate all inputs. No secrets in code. Defense in depth. Least privilege principle. |
| Test-Driven Thinking | Design all code to be testable from inception. Write tests alongside code. Verify before committing. |
## Customization
Two ways to generate rules for your project:
1. **AI Adaptation Prompt**: Fill in your project details and let AI generate IDE-specific configs
```
Use: prompts/adapt-rules-prompt.txt
```
2. **Project Analyzer**: Point AI at your existing codebase to auto-generate rules
```
Use: prompts/project-analyzer-prompt.txt
```
## IDE Support Matrix
| Tool | Config File | AGENTS.md | Multi-File | Glob Patterns |
|------|------------|-----------|------------|---------------|
| Cursor | `.cursor/rules/*.mdc` | Native | Yes | Yes (YAML) |
| Windsurf | `.windsurfrules` | Manual | No | No |
| GitHub Copilot | `.github/copilot-instructions.md` | Native | Yes | Yes (applyTo) |
| Claude Code | `CLAUDE.md` + `.claude/rules/` | Manual | Yes | No (dir-based) |
| Cline | `.clinerules` or `.clinerules/` | Native | Yes | Yes (YAML) |
| Codex | `AGENTS.md` | Native | Yes (dir-based) | No |
| Zed AI | `.rules` | Native | No | No |
| Gemini CLI | `GEMINI.md` | Native | Yes (dir-based) | No |
| Aider | `conventions.md` | Native | No | No |
| Continue.dev | `.continue/rules/*.md` | No | Yes | Yes (YAML globs) |
## Coming from the old Windsurf Global Rules?
If you've been using our original `global_rules.md` and `.windsurfrules` — they're still here, now as part of a much bigger toolkit. You'll find the original Windsurf rules as a ready-to-use example in [`ide-specific/windsurf/examples/`](ide-specific/windsurf/examples/), alongside new templates that work across all 10 IDEs.
For the thinking behind this approach, check out these articles:
- [Agent Harness: Warum 90% der KI-Agenten scheitern](https://www.obviousworks.ch/agent-harness-warum-90-der-ki-agenten-scheitern-und-wie-du-es-besser-machst/) — Why structure and guardrails matter more than the model
- [Masterprompt for AI Coding: Der ultimative System-Prompt](https://www.obviousworks.ch/masterprompt-fuer-ai-coding-der-ultimative-system-prompt/) — How to craft system prompts that actually guide AI agents
## Origin
This repository merges and supersedes content from two sources:
- **[vibe-coding-ai-rules](https://github.com/obviousworks/vibe-coding-ai-rules)** — Windsurf-focused global and project rules
- **[agentic-coding-rulebook](https://github.com/obviousworks/agentic-coding-rulebook)** — Universal AGENTS.md templates and best practices
The result: one comprehensive resource covering all major AI coding assistants.
## Contributing
We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
**Ways to contribute:**
- Share production-ready rule examples
- Add support for new IDEs or frameworks
- Improve existing templates with real-world learnings
- Report issues or suggest enhancements
## License
[MIT](LICENSE) — Use freely in personal and commercial projects.
---
## Built by Obviousworks
This repo is maintained by [Obviousworks](https://www.obviousworks.ch) — we help dev teams ship better software with AI.
Everything in this repository reflects what we teach and implement with real teams: effective agent harness structures, production-grade rule systems, and development processes designed around AI from the ground up.
In our [**AI Developer Bootcamp**](https://www.obviousworks.ch/schulungen/ai-developer-bootcamp/) we work hands-on with teams to build exactly this — from writing quality AI coding rules to setting up a complete agentic development workflow that actually scales. And in the [**Agentic Coding Hackathon**](https://www.obviousworks.ch/schulungen/agentic-coding-hackathon/) you get to put it all into practice: build real projects with AI agents in one intensive day, guided by our engineering team.
If your team writes code with AI and wants to do it properly:
- [**AI Developer Bootcamp** — hands-on training for dev teams](https://www.obviousworks.ch/schulungen/ai-developer-bootcamp/)
- [**Agentic Coding Hackathon** — build real projects with AI agents in one day](https://www.obviousworks.ch/schulungen/agentic-coding-hackathon/)
- [Agent Harness: Why 90% of AI agents fail (and how to fix it)](https://www.obviousworks.ch/agent-harness-warum-90-der-ki-agenten-scheitern-und-wie-du-es-besser-machst/)
- [obviousworks.ch](https://www.obviousworks.ch)
Instalação
Instale a skill a partir de https://github.com/obviousworks/vibe-coding-ai-rulesEsta skill não está publicada no registro do ClawHub. Cole o prompt no seu agente de código — Claude Code, Cursor, Codex — e ele instalará a skill direto do repositório de origem.
Abrir o repositório