description	The entry point for developers and AI agents to the Best-Practise AI Context Library.
tags	vibe coding ai agents context injection architectural constraints clean code

🇺🇸 English | 🇷🇺 Русский

Best-Practise: AI Agent Context

"The Gold Standard for AI Agent Context Injection."

⚙️ Context & Scope

• Primary Goal: Provide an AI-readable index for all architectural and technological constraints to ensure Vibe Coding best practices.
• Target Tooling: Cursor, Windsurf, Antigravity, GitHub Copilot.
• Tech Stack Version: Agnostic

---

🚀 The "Vibe Coding" Value Proposition

The Problem: Generic LLMs produce generic code because they lack deep project context. Without strict architectural guidelines, codebases built with AI quickly turn into unmaintainable spaghetti code.

The Solution: This repository provides a global, open-source library of meta-instructions for Vibe Coding. By injecting these strict architectural constraints into your AI agents, you ensure deterministic, scalable, and "beautiful" production-ready code generation.

---

🗺️ Interactive Tech Stack Map

Domain	Technology	Status
Frontend	Angular 20+ JavaScript (ES6+) TypeScript	✅
Backend	NestJS Express.js Node.js	✅
Architecture	📐 Feature-Sliced Design (FSD) 🏗️ MVC	🛠️

---

🤖 Топ-10 AI Агентов и Инструментов (IDE)

В современных реалиях Vibe Coding активно используются следующие мощные AI инструменты. Вот 10 самых популярных из них:

Логотип	Инструмент	Описание
	Cursor AI	An advanced fork of VS Code, deeply integrated with models (Claude 3.5 Sonnet, GPT-4o) for autocompletion and refactoring of entire codebases.
	Antigravity IDE	A powerful standalone environment and AI agent from the Google DeepMind team. Understands complex context and multi-step tasks.
	GitHub Copilot	The main AI assistant from GitHub and OpenAI, which pioneered code autocompletion and continues to evolve (Copilot Workspace).
	Windsurf	A revolutionary IDE from Codeium with "streaming" interaction between agents and programmers (Flow State).
	Cline (formerly Devin/Claude Dev)	An autonomous AI developer right in your VS Code, capable of creating projects from scratch and running commands in the terminal.
	Aider	A console AI agent that works perfectly with Git repositories and allows you to manage projects directly from the terminal.
	Codeium	A completely free (for private use) and lightning-fast AI assistant that integrates into any development environment.
	Tabnine	Enterprise-level solution with a high degree of confidentiality, trained on your own code without leaks to public models.
	Amazon Q Developer	An assistant from AWS (formerly CodeWhisperer), ideal for integration with cloud infrastructure and vulnerability scanning.
	Sourcegraph Cody	An instrument with deep access to your enterprise code graph for ultra-precise search and generation.

---

🎯 Integration Guide: Injecting AI Context

To establish a deterministic, scalable Agentic Workflow, engineers must perform Context Injection. By injecting these Deterministic Rules into your AI toolchain, you ensure that agents strictly adhere to the project's baseline architecture and constraints.

Context Injection Lifecycle

graph LR
    A[Best-Practise Library] --> B[Select Technology .md]
    B --> C[Copy to Local .ide-folder/]
    C --> D[AI Agent Activation]
    %% Added 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 C component;
    class A component;
    class D component;
    class B component;

Loading

Folder Mapping Table

For the Deterministic Rules to be accurately parsed and strictly followed, instructions MUST be placed in these specific hidden directories based on your AI tooling:

AI Tool	Instruction Directory Mapping
Antigravity IDE	.agents/rules/*.md
Cursor AI	.cursor/rules/*.md
Windsurf	.windsurf/rules/
GitHub Copilot	.github/copilot-instructions.md (or root .github/ for general context)
Cloud Code AI / Claude Code	Root directory or .claude/ (depending on agent configuration)

---

🛠️ Visual Architecture: Context Deep-Dive

The repository is structured hierarchically to allow AI agents to progressively deepen their understanding of your project constraints.

graph TD
    A["📄 Root: agents.md"] --> B{"🌐 Domain"}
    B -->|Frontend| C1["🖥️ frontend/readme.md"]
    B -->|Backend| C2["⚙️ backend/readme.md"]
    B -->|Architecture|C3["📐 architectures/readme.md"]
    
    C1 --> D1["🅰️ Technology: angular/readme.md"]
    C2 --> D2["🐱 Technology: nestjs/readme.md"]
    C3 --> D3["🧩 Architecture: fsd/readme.md"]
    
    D1 --> E1["⚡ Specification: performance.md"]
    D1 --> E2["📦 Specification: state-management.md"]
    
    D2 --> E3["🛡️ Specification: security.md"]
    D2 --> E4["🗄️ Specification: database.md"]

    D3 --> E5["📚 Specification: layer-isolation.md"]
    D3 --> E6["🚪 Specification: public-api-policy.md"]
    
    %% Clickable Links
    click A "agents.md"
    click C1 "frontend/readme.md"
    click C2 "backend/readme.md"
    click C3 "architectures/readme.md"
    click D1 "frontend/angular/readme.md"
    click D2 "backend/nestjs/readme.md"
    click D3 "architectures/fsd/readme.md"
    click E1 "frontend/angular/performance.md"
    click E2 "frontend/angular/state-management.md"
    click E3 "backend/nestjs/security.md"
    click E4 "backend/nestjs/database.md"
    click E5 "architectures/fsd/layer-isolation.md"
    click E6 "architectures/fsd/public-api-policy.md"
    
    %% Styling
    classDef root fill:#f9f,font-weight:bold,stroke:#333,stroke-width:2px,color:#111;
    classDef domain fill:#bbf,font-weight:bold,stroke:#333,stroke-width:2px,color:#111;
    classDef tech fill:#bfb,font-weight:bold,stroke:#333,stroke-width:2px,color:#111;
    classDef spec fill:#fbb,font-weight:bold,stroke:#333,stroke-width:2px,color:#111;
    
    class A root;
    class B,C1,C2,C3 domain;
    class D1,D2,D3 tech;
    class E1,E2,E3,E4,E5,E6 spec;
    %% Added 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 E1 component;
    class E5 component;
    class E3 component;
    class E6 component;
    class D3 component;
    class C1 component;
    class E2 component;
    class D1 component;
    class D2 component;
    class E4 component;
    class C2 component;
    class C3 component;
    class B component;

Loading

🌴 Folder Tree

• 📦 best-practise
  • 📄 agents.md
  • 🌐 architectures/
    • 📄 readme.md
    • 🧩 fsd/
      • 📚 layer-isolation.md
      • 🚪 public-api-policy.md
      • 📄 readme.md
    • 🏗️ mvc/
      • 📄 readme.md
  • ⚙️ backend/
    • 📄 readme.md
    • 🚂 express/
      • 📄 readme.md
    • 🐱 nestjs/
      • 🗄️ database.md
      • 📄 readme.md
      • 🛡️ security.md
    • 🟢 nodejs/
      • 📄 readme.md
  • 🖥️ frontend/
    • 📄 readme.md
    • 🅰️ angular/
      • ⚡ performance.md
      • 📄 readme.md
      • 📦 state-management.md
    • 🟨 javascript/
      • 📄 readme.md
    • 🟦 typescript/
      • 📄 readme.md

---

🤝 How to Contribute

This is a living repository. Even if you're building alone, the AI ecosystem thrives on shared knowledge. If you are an expert in a specific technology, we invite you to add your specific constraints and rules!

1. Fork the repository.
2. Navigate to the appropriate [domain]/[technology]/ folder (or create it).
3. Add a readme.md with core principles, and break down complex rules into specific markdown files.
4. Submit a Pull Request.

---

Author: Jamoliddin Qodirov (Software Architect & Teacher)

---

Best-Practise: Контекст агента ИИ

"Золотой стандарт для внедрения контекста в ИИ-агентствах."

⚙️ Контекст & Сфера применения

• Основная цель: Обеспечить AI-читаемый индекс для трансляции архитектурных концепций и технологических Constraints (Ограничения) с целью обеспечения стандартов Vibe Coding.
• Целевое ПО (Target Tooling): Cursor, Windsurf, Antigravity, GitHub Copilot.
• Версия техстека: Агностична

---

🚀 "Vibe Coding" Ценностное предложение

Проблема: Базовые LLM генерируют абстрактный код по причине дефицита глубокого контекста о проекте. Отсутствие строго регламентированных архитектурных ограничений неизбежно приводит к переходу кодовой базы, сгенерированной ИИ, в технический долг (спагетти-код) и провоцирует Hallucinations (Галлюцинации).

Решение: Данный репозиторий представляет собой эталонную open-source библиотеку мета-инструкций для Vibe Coding. Осуществляя строгий AI Context Injection в ваших агентах, вы достигаете детерминированного транслирования архитектуры, обеспечения масштабируемости и генерации production-ready кода.

---

🗺️ Интерактивная карта технологического стека

Домен	Технология	Статус
Frontend	Angular 20+ JavaScript (ES6+) TypeScript	✅
Backend	NestJS Express.js Node.js	✅
Architecture	📐 Feature-Sliced Design (FSD) 🏗️ MVC	🛠️

---

🤖 Топ-10 AI Агентов и Инструментов (IDE)

В парадигме Vibe Coding в продакшене внедрены следующие ИИ-инструменты. Ниже приведен топ-10 актуальных решений:

Логотип	Инструмент	Описание
	Cursor AI	Продвинутый форк VS Code с нативной интеграцией LLM (Claude 3.5 Sonnet, GPT-4o) для автокомплита и кросс-файлового рефакторинга.
	Antigravity IDE	Высокоуровневая автономная среда с AI-агентом от Google DeepMind. Спроектирована для интерпретации сложного контекста и решения комплексных задач.
	GitHub Copilot	Флагманский ИИ-инструмент интеграции модели от GitHub. Включает парадигму Copilot Workspace для управления репозиториями.
	Windsurf	IDE от Codeium. Внедряет парадигму Flow State для достижения непрерывного потокового взаимодействия "инженер-агент".
	Cline (ex Devin/Claude Dev)	Автономный ИИ-разработчик как расширение VS Code. Осуществляет выполнение консольных команд и bootstrap проектов.
	Aider	Консольный AI-агент. Ориентирован на нативную работу в связке с Git-архитектурой для выполнения команд из терминала.
	Codeium	Производительный ИИ-ассистент, доступный для широкого пула IDE поверх локальной инфраструктуры разработчика.
	Tabnine	Enterprise-решение с упором на секьюрити. Обучается изолированно на инхаус коде для пресечения утечек данных.
	Amazon Q Developer	Корпоративный ассистент от AWS. Внедрен как модуль-профайлер облачных инфраструктур и анализа уязвимостей.
	Sourcegraph Cody	Инструмент для дата-майнинга и анализа Enterprise-кодовых графов, обеспечивающий маппинг компонентов с высокой степенью согласованности.

---

---

🎯 Руководство по интеграции: Инъекция контекста

Для выстраивания детерминированного и масштабируемого Agentic Workflow, разработчики должны реализовать Инъекцию контекста (Context Injection). Интеграция данных Deterministic Rules в ваш инструментарий ИИ гарантирует строгое соблюдение базовой архитектуры и заданных ограничений агентами.

Жизненный цикл Инъекции контекста

graph LR
    A[Best-Practise Library] --> B[Select Technology .md]
    B --> C[Copy to Local .ide-folder/]
    C --> D[AI Agent Activation]
    %% Added 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 C component;
    class A component;
    class D component;
    class B component;

Loading

Таблица: Маппинг директорий

Для того чтобы Deterministic Rules корректно парсились и строго исполнялись ИИ-ассистентами, инструкции ДОЛЖНЫ быть размещены в следующих скрытых директориях, в зависимости от инструмента:

AI Инструмент	Маппинг директорий
Antigravity IDE	.agents/rules/*.md
Cursor AI	.cursor/rules/*.md
Windsurf	.windsurf/rules/
GitHub Copilot	.github/copilot-instructions.md (или корень .github/ для общего контекста)
Cloud Code AI / Claude Code	Корневая директория или .claude/ (в зависимости от конфигурации агента)

---

🛠️ Visual Architecture: Context Deep-Dive

Топология проекта организована иерархически. Архитектура разработана для прогрессивного спускания AI-агентов по информационным узлам (Context Drilling) до спецификаций конкретной технологии.

graph TD
    A["📄 Root: agents.md"] --> B{"🌐 Domain"}
    B -->|Frontend| C1["🖥️ frontend/readme.md"]
    B -->|Backend| C2["⚙️ backend/readme.md"]
    B -->|Architecture|C3["📐 architectures/readme.md"]
    
    C1 --> D1["🅰️ Technology: angular/readme.md"]
    C2 --> D2["🐱 Technology: nestjs/readme.md"]
    C3 --> D3["🧩 Architecture: fsd/readme.md"]
    
    D1 --> E1["⚡ Specification: performance.md"]
    D1 --> E2["📦 Specification: state-management.md"]
    
    D2 --> E3["🛡️ Specification: security.md"]
    D2 --> E4["🗄️ Specification: database.md"]

    D3 --> E5["📚 Specification: layer-isolation.md"]
    D3 --> E6["🚪 Specification: public-api-policy.md"]
    
    %% Clickable Links
    click A "agents.md"
    click C1 "frontend/readme.md"
    click C2 "backend/readme.md"
    click C3 "architectures/readme.md"
    click D1 "frontend/angular/readme.md"
    click D2 "backend/nestjs/readme.md"
    click D3 "architectures/fsd/readme.md"
    click E1 "frontend/angular/performance.md"
    click E2 "frontend/angular/state-management.md"
    click E3 "backend/nestjs/security.md"
    click E4 "backend/nestjs/database.md"
    click E5 "architectures/fsd/layer-isolation.md"
    click E6 "architectures/fsd/public-api-policy.md"
    
    %% Styling
    classDef root fill:#f9f,font-weight:bold,stroke:#333,stroke-width:2px,color:#111;
    classDef domain fill:#bbf,font-weight:bold,stroke:#333,stroke-width:2px,color:#111;
    classDef tech fill:#bfb,font-weight:bold,stroke:#333,stroke-width:2px,color:#111;
    classDef spec fill:#fbb,font-weight:bold,stroke:#333,stroke-width:2px,color:#111;
    
    class A root;
    class B,C1,C2,C3 domain;
    class D1,D2,D3 tech;
    class E1,E2,E3,E4,E5,E6 spec;
    %% Added 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 E1 component;
    class E5 component;
    class E3 component;
    class E6 component;
    class D3 component;
    class C1 component;
    class E2 component;
    class D1 component;
    class D2 component;
    class E4 component;
    class C2 component;
    class C3 component;
    class B component;

Loading

🌴 Folder Tree

• 📦 best-practise
  • 📄 agents.md
  • 🌐 architectures/
    • 📄 readme.md
    • 🧩 fsd/
      • 📚 layer-isolation.md
      • 🚪 public-api-policy.md
      • 📄 readme.md
    • 🏗️ mvc/
      • 📄 readme.md
  • ⚙️ backend/
    • 📄 readme.md
    • 🚂 express/
      • 📄 readme.md
    • 🐱 nestjs/
      • 🗄️ database.md
      • 📄 readme.md
      • 🛡️ security.md
    • 🟢 nodejs/
      • 📄 readme.md
  • 🖥️ frontend/
    • 📄 readme.md
    • 🅰️ angular/
      • ⚡ performance.md
      • 📄 readme.md
      • 📦 state-management.md
    • 🟨 javascript/
      • 📄 readme.md
    • 🟦 typescript/
      • 📄 readme.md

---

🤝 Стать contributer проект

В условиях развития AI-экосистемы аккумулирование Enterprise-опыта является критически важным. Инженерам, обладающим подтвержденной квалификацией (Senior level) в конкретных субдоменах, предлагается расширять реестр Constraints:

1. Выполните Fork проекта.
2. Проведите локализацию в директории [domain]/[technology]/.
3. Реализуйте файл readme.md, декларирующий ключевые парадигмы в рамках стэка. Для покрытия узкоспециализированных кейсов инициируйте декомпозицию с выделением изолированных конфигураций (например, performance.md).
4. Настройте Pull Request в ветку main.

---

Author: Jamoliddin Qodirov (Software Architect & Teacher)