docs: expand lint scope batch45 (2 files)

This commit is contained in:
Apple
2026-02-16 07:40:07 -08:00
parent 168cb76d42
commit 4098649c59
3 changed files with 82 additions and 80 deletions

View File

@@ -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.

View File

@@ -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ільнота працює природно, без формальних таблиць чи менеджерів.

View File

@@ -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