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

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

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..d560a40
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,69 @@
+# AGENTS.md — Verstak Official Plugins
+
+## Назначение
+
+Монорепозиторий официальных плагинов Верстака. Каждый плагин — полноценный динамический плагин, проходящий тот же lifecycle, что и сторонние.
+
+## Состав
+
+```
+verstak-official-plugins/
+  AGENTS.md
+  plugins/
+    platform-test/      — тестовый плагин для проверки runtime
+    files/
+    notes/
+    markdown-editor/
+    markdown-preview/
+    file-preview/
+    activity/
+    journal/
+    browser-inbox/
+    search/
+    secrets/
+    templates/
+  packages/
+    shared-ui/
+    test-harness/
+    plugin-sdk/         — временно, пока SDK не выделен
+  package.json
+  tsconfig.json
+```
+
+## Правила для всех плагинов
+
+1. Каждый плагин имеет plugin.json с полным manifest.
+2. Плагины зависят от capabilities, а не от plugin ID.
+3. Нет скрытого privileged path для official плагинов.
+4. disable не удаляет пользовательские данные.
+5. Отсутствие optional capability — degraded mode, не ошибка.
+6. Plugin Manager показывает статус каждого плагина.
+
+## Первый минимальный набор
+
+- `platform-test` — для отладки runtime
+- `official.files` — файловый менеджер
+- `official.notes` — заметки
+- `official.markdown-editor` — редактор
+- `official.markdown-preview` — предпросмотр
+- `official.activity` — активность
+- `official.browser-inbox` — браузерный inbox
+
+Все они должны быть настоящими динамическими плагинами, даже если поставляются вместе с приложением.
+
+## Структура плагина
+
+```
+plugin-id/
+  plugin.json           — обязательный manifest
+  frontend/
+    index.js            — entry point
+    style.css
+  backend/              — опционально
+    plugin-linux-amd64
+    plugin-windows-amd64.exe
+  migrations/           — опционально
+    001_init.sql
+  assets/
+  README.md
+```