From 4098649c593fdb70b211c2216be663ad37e7d9a5 Mon Sep 17 00:00:00 2001 From: Apple Date: Mon, 16 Feb 2026 07:40:07 -0800 Subject: [PATCH] docs: expand lint scope batch45 (2 files) --- docs/cursor/10_agent_ui_system.md | 91 ++++++++++----------- docs/cursor/16_followups_reminders_agent.md | 69 ++++++++-------- docs/standards/lint_scope.txt | 2 + 3 files changed, 82 insertions(+), 80 deletions(-) diff --git a/docs/cursor/10_agent_ui_system.md b/docs/cursor/10_agent_ui_system.md index b7a1a0f6..ce1229e6 100644 --- a/docs/cursor/10_agent_ui_system.md +++ b/docs/cursor/10_agent_ui_system.md @@ -8,7 +8,7 @@ --- -# 1. Мета +## 1. Мета Зробити агента центральною точкою взаємодії користувача зі спільнотою. @@ -26,7 +26,7 @@ --- -# 2. Типи агентів у UI +## 2. Типи агентів у UI ## 2.1. Guide Agent (провідник) @@ -66,7 +66,7 @@ --- -# 3. Компоненти Agent UI +## 3. Компоненти Agent UI ## 3.1. Agent Bubble @@ -80,12 +80,12 @@ Окремий чат у форматі інтерфейсу: -``` +```text --- | Team Assistant (ім'я агента) | | Chat messages | | Input field | -``` +```text Функції: @@ -123,23 +123,23 @@ --- -# 4. Sidebar інтеграція +## 4. Sidebar інтеграція У лівому меню зʼявляється новий розділ: -``` +```text Агенти • Team Assistant • (у майбутньому: Personal Agent) -``` +```text При натисканні → сторінка агента. --- -# 5. Сторінка агента +## 5. Сторінка агента -### Розташування: +### Розташування `/t/:teamId/agent/:agentId` @@ -209,18 +209,18 @@ UI приклад: -``` +```text Версія: v4.2 Запропоновано 2 покращення: [1] Нове правило: "Відповідати українською, якщо канал український." [Прийняти] [Відхилити] [2] FAQ: "Як додати учасника до команди?" [Прийняти] [Редагувати] -``` +```text --- -# 6. Взаємодія агента з подіями +## 6. Взаємодія агента з подіями ## 6.1. У каналі @@ -244,7 +244,7 @@ UI приклад: --- -# 7. Взаємодія агента з Follow-Ups & Projects +## 7. Взаємодія агента з Follow-Ups & Projects ### 7.1. Follow-ups @@ -270,7 +270,7 @@ UI приклад: --- -# 8. Notification Logic +## 8. Notification Logic Агент sparingly надсилає нотифікації: @@ -296,7 +296,7 @@ UI: --- -# 9. Анімації та UX-поведінка +## 9. Анімації та UX-поведінка - Аватар агента реагує на події (мʼяка анімована "пульсація"). @@ -308,7 +308,7 @@ UI: --- -# 10. Інтеграція з Agent-First Onboarding +## 10. Інтеграція з Agent-First Onboarding Після онбордингу: @@ -322,17 +322,17 @@ UI: --- -# 11. Завдання для Cursor +## 11. Завдання для Cursor -``` +```text You are a senior React/TS engineer. Implement Agent UI System using: -* 10_agent_ui_system.md -* 08_agent_first_onboarding.md -* 03_api_core_snapshot.md -* 05_coding_standards.md +- 10_agent_ui_system.md +- 08_agent_first_onboarding.md +- 03_api_core_snapshot.md +- 05_coding_standards.md Deliverables: @@ -344,50 +344,50 @@ Deliverables: Output: -* list of modified files -* diff -* summary -``` +- list of modified files +- diff +- summary +```text --- -# 12. Компоненти та структура файлів +## 12. Компоненти та структура файлів ## 12.1. Компоненти UI -``` +```text src/components/agent/ AgentBubble.tsx # Фіксований аватар у правому нижньому куті AgentChatWindow.tsx # Окно чату з агентом AgentMessage.tsx # Повідомлення агента в каналах AgentAvatar.tsx # Аватар агента з анімаціями AgentTypingIndicator.tsx # Індикатор набору тексту -``` +```text ## 12.2. Сторінки -``` +```text src/pages/ AgentPage.tsx # Головна сторінка агента з вкладками AgentChatTab.tsx # Вкладка чату AgentMemoryTab.tsx # Вкладка пам'яті AgentLearningTab.tsx # Вкладка самонавчання AgentEvolutionTab.tsx # Вкладка еволюції -``` +```text ## 12.3. Hooks -``` +```text src/hooks/ useAgentActions.ts # Дії агента (відповіді, аналіз) useAgentNotifications.ts # Нотифікації від агента useAgentMemory.ts # Робота з пам'яттю агента useAgentEvolution.ts # Еволюція агента (з 09_evolutionary_agent.md) -``` +```text ## 12.4. Типи -``` +```text src/types/ agent.ts # Типи для агентів - Agent @@ -395,11 +395,11 @@ src/types/ - AgentSuggestion - AgentVersion - AgentMemory -``` +```text --- -# 13. Інтеграція з каналами +## 13. Інтеграція з каналами ## 13.1. Відображення повідомлень агента @@ -433,7 +433,7 @@ src/types/ --- -# 14. API інтеграція +## 14. API інтеграція ## 14.1. Отримання відповіді від агента @@ -446,13 +446,13 @@ POST /agents/{agentId}/chat "threadId": "thread-456" } } -``` +```text ## 14.2. Отримання пам'яті агента ```ts GET /agents/{agentId}/memory -``` +```text ## 14.3. Оновлення налаштувань самонавчання @@ -463,11 +463,11 @@ PATCH /agents/{agentId}/learning "level": "extended", "sources": ["channel", "team"] } -``` +```text --- -# 15. UX деталі +## 15. UX деталі ## 15.1. Agent Bubble @@ -492,7 +492,7 @@ PATCH /agents/{agentId}/learning --- -# 16. Обробка помилок +## 16. Обробка помилок ## 16.1. Помилки API @@ -512,7 +512,7 @@ PATCH /agents/{agentId}/learning --- -# 17. Тестування +## 17. Тестування ## 17.1. Unit Tests @@ -535,7 +535,7 @@ PATCH /agents/{agentId}/learning --- -# 18. Результат +## 18. Результат MicroDAO стає не месенджером з агентами, а **агентською операційною системою спільнот**, де ШІ — активний навігатор, який еволюціонує та живе поруч з людьми. @@ -552,4 +552,3 @@ MicroDAO стає не месенджером з агентами, а **аген **Готово.** Це **повна специфікація агентського UI системи**, готова до використання в Cursor. - diff --git a/docs/cursor/16_followups_reminders_agent.md b/docs/cursor/16_followups_reminders_agent.md index 79ddbd5c..5a3fb0fd 100644 --- a/docs/cursor/16_followups_reminders_agent.md +++ b/docs/cursor/16_followups_reminders_agent.md @@ -2,11 +2,14 @@ Агент-нагадувань, ритму та повторних дій у MicroDAO -Агент Follow-ups & Reminders (далі — Followup Agent) відповідає за ритм роботи, дисципліну задач, таймінг і "догляд" за станом спільноти та проєктів. Він є природним продовженням Projects Agent і Messenger Agent, але має власну функціональність і власну памʼять. +Агент Follow-ups & Reminders (далі — Followup Agent) відповідає за ритм +роботи, дисципліну задач, таймінг і "догляд" за станом спільноти та проєктів. +Він є природним продовженням Projects Agent і Messenger Agent, але має власну +функціональність і власну памʼять. --- -# 1. Ідея +## 1. Ідея Followup Agent — це: @@ -20,7 +23,7 @@ Followup Agent — це: --- -# 2. Ролі агентів у модулі +## 2. Ролі агентів у модулі ### 2.1. Followup Agent (основний) @@ -44,7 +47,7 @@ Followup Agent — це: --- -# 3. Документи, які породжує Followup Agent +## 3. Документи, які породжує Followup Agent Цей агент може автоматично створювати: @@ -72,7 +75,7 @@ Followup Agent — це: --- -# 4. Logics — коли агент активується +## 4. Logics — коли агент активується ### 4.1. Фрази-тригери в чатах @@ -113,7 +116,7 @@ Agent пропонує: --- -# 5. Інтеграція з Projects Agent +## 5. Інтеграція з Projects Agent Followup Agent працює разом з Projects Agent: @@ -123,13 +126,13 @@ Followup Agent працює разом з Projects Agent: --- -# 6. Tools (для інтеграції з Runtime Core) +## 6. Tools (для інтеграції з Runtime Core) Список інструментів, які Followup Agent використовує у форматі 12_agent_runtime_core.md: ### 6.1. create_followup -``` +```text create_followup({ project_id?, task_id?, @@ -137,45 +140,45 @@ user_id?, message, schedule // "in 1 hour", "tomorrow 09:00", CRON-like }) -``` +```text ### 6.2. create_reminder -``` +```text create_reminder({ user_id, message, schedule }) -``` +```text ### 6.3. check_task_status -``` +```text check_task_status(task_id) -``` +```text ### 6.4. ask_for_update -``` +```text ask_for_update(task_id, assignee) -``` +```text ### 6.5. daily_digest -``` +```text daily_digest(project_id | team_id) -``` +```text ### 6.6. weekly_review -``` +```text weekly_review(project_id | team_id) -``` +```text --- -# 7. Memory інтеграція (13) +## 7. Memory інтеграція (13) Followup Agent активно використовує памʼять: @@ -200,7 +203,7 @@ Followup Agent активно використовує памʼять: --- -# 8. UI інтеграція +## 8. UI інтеграція ## 8.1. Sidebar / Панель фоллоуапів @@ -237,7 +240,7 @@ Followup Agent постійно додає записи: --- -# 9. API +## 9. API ### 9.1. Follow-ups @@ -258,7 +261,7 @@ Followup Agent постійно додає записи: --- -# 10. Agent конфіг у Runtime Core +## 10. Agent конфіг у Runtime Core ```ts const followupAgentConfig: AgentConfig = { @@ -277,15 +280,15 @@ const followupAgentConfig: AgentConfig = { "weekly_review" ] }; -``` +```text --- -# 11. Інструкції для Cursor +## 11. Інструкції для Cursor Приклад промта: -``` +```text Implement the Follow-ups & Reminders Agent using: - 16_followups_reminders_agent.md @@ -323,17 +326,15 @@ Output: - files list - diff - summary -``` +```text --- -# 12. Результат +## 12. Результат Після впровадження Followup Agent: -* microDAO має власного "агента-організатора ритму", -* задачі й домовленості ніколи не губляться, -* наявна здатність до самодисципліни та самонагляду, -* spільнота працює природно, без формальних таблиць чи менеджерів. - - +- microDAO має власного "агента-організатора ритму", +- задачі й домовленості ніколи не губляться, +- наявна здатність до самодисципліни та самонагляду, +- spільнота працює природно, без формальних таблиць чи менеджерів. diff --git a/docs/standards/lint_scope.txt b/docs/standards/lint_scope.txt index a54038f3..73d26a4c 100644 --- a/docs/standards/lint_scope.txt +++ b/docs/standards/lint_scope.txt @@ -119,3 +119,5 @@ docs/cursor/18_governance_access_agent.md docs/cursor/23_agent_cards_and_console.md docs/cursor/09_evolutionary_agent.md docs/cursor/03_api_core_snapshot.md +docs/cursor/10_agent_ui_system.md +docs/cursor/16_followups_reminders_agent.md