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.