From bd06d5734c5d2867456a61cd1de8a4a355180054 Mon Sep 17 00:00:00 2001
From: Dmitry Dementev <me@dementev.space>
Date: Wed, 11 Mar 2026 15:16:19 +0300
Subject: [PATCH] =?UTF-8?q?docs(root):=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?=
 =?UTF-8?q?=D0=BB=D0=B5=D0=BD=20AGENTS.md=20=D1=81=20=D0=BE=D0=BF=D0=B8?=
 =?UTF-8?q?=D1=81=D0=B0=D0=BD=D0=B8=D0=B5=D0=BC=20=D1=81=D1=82=D1=80=D1=83?=
 =?UTF-8?q?=D0=BA=D1=82=D1=83=D1=80=D1=8B=20=D0=BF=D1=80=D0=BE=D0=B5=D0=BA?=
 =?UTF-8?q?=D1=82=D0=B0=20=D0=B8=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=20?=
 =?UTF-8?q?=D0=B4=D0=BB=D1=8F=20=D0=98=D0=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Зачем:
  - предоставить ИИ-агентам контекст по структуре репозитория (Bash, Tmux, Vim, VS Code, AI skills) и принятым в нем стандартам.
- Что:
  - создан файл `AGENTS.md` с описанием ключевых компонентов, способов развертывания (`stow`/`chezmoi`) и правил взаимодействия с Git.
- Проверка:
  - файл успешно добавлен в репозиторий и доступен для чтения агентами.
---
 AGENTS.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..0c027ca
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,56 @@
+# GEMINI.md - Project Context & Instructions
+
+This repository contains personal dotfiles and configurations for a highly productive development environment, integrating Bash, Tmux, Vim, VS Code, and various AI assistants (Gemini CLI, Claude, Codex, Opencode).
+
+## 📂 Project Overview
+
+*   **Type:** Non-Code Project (Dotfiles / Configuration)
+*   **Management:** Uses `stow` for Linux/WSL and `chezmoi` for Windows/WSL.
+*   **Key Focus:** 
+    *   Unified configuration across editors and terminals.
+    *   Deep integration with AI tools via shared "skills".
+    *   Automated environment setup (proxy handling, secret loading).
+
+## 🛠 Key Components
+
+### 1. Shell & Terminal (Bash & Tmux)
+*   **Bash:** Custom prompt (`.bash_prompt`), utility functions (`.bash_functions` like `proxy_on/off`), and core customizations (`.bash_custom`).
+*   **Tmux:** Dual prefix (`C-b` and `C-Space`), Vi-mode for copying, and optimized pane management.
+*   **Secrets:** Managed via `~/.env.secrets` (not tracked in Git).
+
+### 2. Editors (Vim, VS Code, Zed)
+*   **Vim:** Minimalist `.vimrc`, 2-space indentation, leader-key mappings (`Space`).
+*   **VS Code (WSL):** Uses `server-env-setup` to automatically load secrets and configure proxy settings upon startup.
+*   **Zed:** Placeholder directory for future configuration.
+
+### 3. AI Agents & Skills
+*   **Shared Skills:** Located in `agents/.agents/skills/`. This is the single source of truth for AI instructions.
+*   **Gemini CLI:** Configured via `gemini/.gemini/`. 
+    *   **Policies:** `readonly-commands.toml` allows critical commands like `git status`, `git diff`, and `git add` to run without confirmation.
+*   **Opencode:** MCP-based assistant configuration (`opencode.json`) with support for documentation, search, and web-reading.
+*   **Skill Bridges:** Symlinks are used to share skills across Claude, Codex, and Opencode.
+
+## 🚀 Usage & Maintenance
+
+### Deployment
+*   **Linux/WSL:** Use `stow <package_name>` from the root directory.
+*   **Windows:** Use `chezmoi apply`.
+
+### Adding/Updating Skills
+1.  Modify files in `agents/.agents/skills/`.
+2.  Ensure symlinks in other tool directories are updated if new skills are added.
+
+### Git Workflow for AI (Gemini CLI)
+*   **Safe Commands:** `git status`, `git diff`, and `git add` are pre-approved in the policy.
+*   **Commits:** Always use the `conventional-commits` skill for generating commit messages. Use the ` Способ B` (temporary file) if direct Heredoc causes issues.
+
+## ⚠️ Important Files for Reference
+*   `README.md`: Detailed installation and usage instructions.
+*   `bash/.bash_functions`: Proxy and environment management functions.
+*   `gemini/.gemini/policies/readonly-commands.toml`: Permissions for Gemini CLI.
+*   `agents/.agents/skills/conventional-commits/SKILL.md`: Rules for commit formatting.
+
+## 🤖 AI Interaction Mandates
+*   **Adhere to Local Patterns:** When suggesting changes, follow the 2-space indent rule and minimalist style established in `.vimrc` and `.bash_custom`.
+*   **Privacy First:** Never log or commit contents of `~/.env.secrets`.
+*   **Verification:** Before updating configs, verify with `git status` and `git diff` (which are allowed without confirmation).