From 40c75258ea86a3339198fc85b4ac3c943def8ac2 Mon Sep 17 00:00:00 2001 From: Apple Date: Mon, 16 Feb 2026 07:35:23 -0800 Subject: [PATCH] docs: expand lint scope batch42 (2 files) --- docs/cursor/21_agent_only_interface.md | 64 +++++++++---------- .../40_rwa_energy_food_water_flow_specs.md | 24 ++++--- docs/standards/lint_scope.txt | 2 + 3 files changed, 44 insertions(+), 46 deletions(-) diff --git a/docs/cursor/21_agent_only_interface.md b/docs/cursor/21_agent_only_interface.md index d225f746..08ed82b3 100644 --- a/docs/cursor/21_agent_only_interface.md +++ b/docs/cursor/21_agent_only_interface.md @@ -24,7 +24,7 @@ --- -# 1. Мета +## 1. Мета Перетворити MicroDAO на **агентську ОС спільнот**, де: @@ -42,11 +42,11 @@ - діалог з агентом, - - + технічні дії (RBAC, entitlements, web3-транзакції). + - технічні дії (RBAC, entitlements, web3-транзакції). --- -# 2. Загальний layout агентської ОС +## 2. Загальний layout агентської ОС ## 2.1. Лівий сайдбар — Простори та Учасники @@ -146,7 +146,7 @@ --- -# 3. Панель "Люди / Агенти / Роботи" +## 3. Панель "Люди / Агенти / Роботи" ## 3.1. Люди @@ -224,7 +224,7 @@ --- -# 4. Запрошення агентів до каналів/чатів +## 4. Запрошення агентів до каналів/чатів ## 4.1. UX-флоу @@ -292,7 +292,7 @@ --- -# 5. Обмін проєктами / базами даних між людьми та агентами +## 5. Обмін проєктами / базами даних між людьми та агентами ## 5.1. Поняття "Ресурсу" @@ -356,7 +356,7 @@ --- -# 6. "Agent Hub" — стартовий екран без меню +## 6. "Agent Hub" — стартовий екран без меню Замість класичного "Home": @@ -408,7 +408,7 @@ --- -# 7. Мінімальний MVP цієї парадигми +## 7. Мінімальний MVP цієї парадигми Для першої реалізації (без надроздуття): @@ -444,11 +444,11 @@ --- -# 8. Компоненти та структура +## 8. Компоненти та структура ## 8.1. Layout Components -``` +```text src/layouts/ AgentOSLayout.tsx # Головний layout з 3 колонками LeftSidebar.tsx # Простори + Учасники @@ -456,24 +456,24 @@ src/layouts/ RightSidebar.tsx # Контекст + Ресурси ContextPanel.tsx # Панель контексту ResourcesPanel.tsx # Панель ресурсів -``` +```text ## 8.2. Pages -``` +```text src/pages/ AgentHubPage.tsx # /t/:teamId/home - стартовий екран ParticipantPage.tsx # Сторінка учасника (людина/агент) -``` +```text ## 8.3. Modals -``` +```text src/components/modals/ AddParticipantModal.tsx # Додати учасника до каналу/чату ShareResourceModal.tsx # Поділитися ресурсом ManageAccessModal.tsx # Керування доступами -``` +```text ## 8.4. Types @@ -501,11 +501,11 @@ interface Entitlement { resourceId: string; scopes: string[]; } -``` +```text --- -# 9. API Endpoints +## 9. API Endpoints ## 9.1. Participants @@ -523,7 +523,7 @@ POST /channels/{channelId}/participants participantType: "human" | "agent"; scopes: string[]; } -``` +```text ## 9.2. Resources @@ -537,7 +537,7 @@ POST /resources/{resourceId}/share participantIds: string[]; scopes: string[]; } -``` +```text ## 9.3. Entitlements @@ -553,11 +553,11 @@ POST /entitlements resourceId: string; scopes: string[]; } -``` +```text --- -# 10. Інтеграція з існуючими модулями +## 10. Інтеграція з існуючими модулями ## 10.1. Messenger Agent (14) @@ -585,11 +585,11 @@ Governance Agent: --- -# 11. Завдання для Cursor +## 11. Завдання для Cursor Приклад промта: -``` +```text You are a senior React/TS engineer. Implement the Agent-Only Interface shell using: @@ -626,29 +626,27 @@ Output: - list of modified files - diff - summary -``` +```text --- -# 12. Результат +## 12. Результат Після впровадження цього модуля: -* MicroDAO отримує "агентський" каркас інтерфейсу: +- MicroDAO отримує "агентський" каркас інтерфейсу: - * вхід через Agent Hub, + - вхід через Agent Hub, - * центральна роль агентів, + - центральна роль агентів, - * простий механізм запрошення агентів, + - простий механізм запрошення агентів, - * базові flows шерингу ресурсів; + - базові flows шерингу ресурсів; -* класичний месенджер (документ 14) стає лише однією з "здібностей" всередині агентської ОС, а не центром продукту. +- класичний месенджер (документ 14) стає лише однією з "здібностей" всередині агентської ОС, а не центром продукту. --- **Готово.** Це **повна специфікація Agent-Only Interface**, готова до використання в Cursor. - - diff --git a/docs/cursor/40_rwa_energy_food_water_flow_specs.md b/docs/cursor/40_rwa_energy_food_water_flow_specs.md index c115d8cf..b885d7b5 100644 --- a/docs/cursor/40_rwa_energy_food_water_flow_specs.md +++ b/docs/cursor/40_rwa_energy_food_water_flow_specs.md @@ -108,7 +108,7 @@ subject = emb_ } ``` -### Поля: +### Поля - `source`: назва платформи - `domain`: energy | food | water @@ -142,17 +142,17 @@ create table rwa_inventory ( ### 7.1 ENERGY Domain -#### Одиниця: +#### Energy Unit -**kWh** +#### kWh -#### Джерела: +#### Energy Sources - сонячні панелі, - біогазові станції, - інвертори. -#### Потік: +#### Energy Flow 1. Device → EnergyUnion 2. EnergyUnion → Embassy (`POST /embassy/energy`) @@ -176,18 +176,18 @@ create table rwa_inventory ( ### 7.2 FOOD Domain -#### Одиниця: +#### Food Unit **kg** або **units** (залежно від товару) -#### Джерела: +#### Food Sources - агропідприємства, - ферми, - парники, - склади GreenFood. -#### Потік: +#### Food Flow 1. GREENFOOD → Embassy (`POST /embassy/food`) 2. Gateway → PDP @@ -203,11 +203,11 @@ create table rwa_inventory ( ### 7.3 WATER Domain -#### Одиниця: +#### Water Unit -**m³** +#### m³ -#### Джерела: +#### Water Sources - фільтрувальні станції, - водні вузли, @@ -454,5 +454,3 @@ Output: **Версія:** 1.0 **Останнє оновлення:** 2024-11-14 - - diff --git a/docs/standards/lint_scope.txt b/docs/standards/lint_scope.txt index a82978a7..98053b58 100644 --- a/docs/standards/lint_scope.txt +++ b/docs/standards/lint_scope.txt @@ -113,3 +113,5 @@ docs/cursor/48_teams_access_control_and_confidential_mode.md docs/cursor/50_daarion_city_website_integration.md docs/cursor/MVP_VERTICAL_SLICE.md docs/cursor/42_nats_event_streams_and_event_catalog.md +docs/cursor/21_agent_only_interface.md +docs/cursor/40_rwa_energy_food_water_flow_specs.md