docs(ai-agents): add Antigravity IDE vibe coding best practices

docs/antigravity-ide-vibe-coding.md

@@ -0,0 +1,62 @@
+---
+description: Discover the ultimate vibe coding and AI Agents guidelines for the Antigravity IDE. Understand core memory strategies and context optimization.
+tags: [vibe coding, AI Agents, Antigravity IDE, context window, ai coding]
+---
+
+# Antigravity IDE Vibe Coding Best Practices
+
+When using the Antigravity IDE, applying the best practices is essential for efficient vibe coding. By understanding how AI Agents interact with this standalone environment, developers can generate highly optimized, production-ready code.
+
+## Context and Scope
+
+- **Primary Goal:** Provide an actionable guide for using AI Agents within the Antigravity IDE.
+- **Target Tooling:** Antigravity IDE.
+- **Tech Stack Version:** Agnostic.
+
+<div align="center">
+  <img src="https://img.icons8.com/?size=100&id=46101&format=png&color=000000" width="100" alt="Antigravity IDE Docs Logo">
+
+  **Mastering Vibe Coding with Antigravity**
+</div>
+
+## Context Window Management for AI Agents
+
+Antigravity IDE is deeply integrated with large context window capabilities. Efficient Context Window Management ensures that the AI Agents do not hallucinate and can precisely follow instructions for vibe coding.
+
+```mermaid
+graph TD
+    UserPrompt[Developer Prompt] --> ContextManager[Context Window Management]
+    Codebase[Local Codebase Context] --> SystemConstraints[System Constraints]
+    SystemConstraints --> ContextManager
+    ContextManager --> AIProcessor[AI Agents Generation]
+
+    %% Design Token Styles for Mermaid Diagrams
+    classDef default fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,color:#000;
+    classDef component fill:#e8f5e9,stroke:#4caf50,stroke-width:2px,color:#000;
+    classDef layout fill:#f3e5f5,stroke:#9c27b0,stroke-width:2px,color:#000;
+
+    class AIProcessor component;
+    class ContextManager component;
+    class UserPrompt default;
+    class Codebase layout;
+```
+
+## System Constraints and Memory Strategies
+
+To achieve enterprise-grade scalability, it is important to utilize memory strategies effectively. The following table illustrates the recommended memory strategies inside the Antigravity IDE.
+
+| Strategy Name | Description | Use Case |
+| :--- | :--- | :--- |
+| **Agentic Rulesets** | Providing static `.agents/rules` files. | High-level system design |
+| **Active File Focus** | Keeping only necessary files open. | Direct refactoring |
+| **Semantic Search** | Vector search across the codebase. | Broad feature discovery |
+
+## Production-Ready Actionable Checklist
+
+To ensure a smooth vibe coding experience, use this checklist before invoking the AI Agents:
+
+- [ ] Verify that all active tabs in the Antigravity IDE are relevant to the current task.
+- [ ] Write precise prompts referencing explicit file paths.
+- [ ] Confirm that your local rules files are updated and indexed.
+- [ ] Review the generated code against the established architectural patterns.
+- [ ] Keep the context window lean to prevent AI memory overflow.