docs: expand lint scope batch45 (2 files)
This commit is contained in:
@@ -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.
|
||||
|
||||
|
||||
|
||||
@@ -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ільнота працює природно, без формальних таблиць чи менеджерів.
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user