From 8ead372c8d89d6615b49ba8365da6ddd6e01a41a Mon Sep 17 00:00:00 2001
From: mirivlad <mirvtop@yandex.ru>
Date: Tue, 16 Jun 2026 11:53:20 +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..16b05a0
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,44 @@
+# AGENTS.md — Verstak Sync Server
+
+## Назначение
+
+Отдельный сервер синхронизации для Верстака. Обеспечивает синхронизацию vault между устройствами.
+
+## Правила
+
+- Sync server не импортирует desktop UI или official plugins.
+- Sync server синхронизирует vault metadata, файлы/blobs, plugin state (где разрешено).
+- Плагины явно указывают, какие данные можно синхронизировать.
+- Sync — не источник правды, а дополнение.
+
+## API
+
+```
+POST   /api/v1/pair          — создание пары устройство-сервер
+POST   /api/v1/auth           — аутентификация
+GET    /api/v1/devices         — список устройств
+POST   /api/v1/sync           — синхронизация операций
+GET    /api/v1/blob/:hash     — скачать blob
+PUT    /api/v1/blob/:hash     — загрузить blob
+GET    /api/v1/operations     — получить операции с последнего sync point
+```
+
+## Структура
+
+```
+verstak-sync-server/
+  AGENTS.md
+  cmd/
+    server/
+  internal/
+    api/
+    auth/
+    device/
+    vault/
+    blob/
+    conflict/
+  migrations/
+    ...
+  go.mod
+  README.md
+```