From 92a82434ab53250c8a8203d5c7f322e6b2503513 Mon Sep 17 00:00:00 2001
From: mirivlad <mirvtop@yandex.ru>
Date: Tue, 16 Jun 2026 11:53:22 +0800
Subject: [PATCH] docs: add AGENTS.md with platform architecture rules

---
 AGENTS.md | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..a52c6b7
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,44 @@
+# AGENTS.md — Verstak Browser Extension
+
+## Назначение
+
+Расширение браузера для Верстака. Позволяет отправлять страницы, выделенный текст, ссылки и скриншоты в Verstak.
+
+## Правила
+
+- Расширение не знает внутреннюю структуру notes/files/activity.
+- Отправляет события в local receiver, обработка — через official.browser-inbox.
+- Работает offline: складывает в pending queue.
+- Поддерживает domain bindings (привязка доменов к делам).
+
+## Состав
+
+```
+verstak-browser-extension/
+  AGENTS.md
+  firefox/
+    manifest.json
+    background.js
+    content.js
+    popup/
+  chromium/
+    manifest.json
+    background.js
+    content.js
+    popup/
+  shared/
+    api.js
+    capture.js
+    queue.js
+    domain-bindings.js
+  package.json
+  README.md
+```
+
+## Возможности
+
+- Page capture — отправка полной страницы
+- Selected text capture — отправка выделенного текста
+- Link sending — отправка ссылки
+- Pending queue — если desktop offline
+- Domain bindings — привязка к делу