chore: organize documentation structure for monorepo
- Create /docs structure (microdao, daarion, agents) - Organize 61 cursor technical docs - Add README files for each category - Copy key documents to public categories - Add GitHub setup instructions and scripts
This commit is contained in:
Apple
335
docs/cursor/19_notifications_attention_agent.md
Normal file
335
docs/cursor/19_notifications_attention_agent.md
Normal file
@@ -0,0 +1,335 @@
|
||||
# 19 — Notifications & Attention Agent (MicroDAO)
|
||||
|
||||
Агент уваги, тиші та інформаційного ритму
|
||||
|
||||
Notifications & Attention Agent (далі — Attention Agent) відповідає за *ритм сповіщень* та *інформаційну гігієну* в microDAO.
|
||||
Його мета — захистити учасників від шуму та втоми, залишивши лише важливе.
|
||||
|
||||
Це не "push-нотифікації".
|
||||
Це **агент управління увагою** — частина "нервової системи" microDAO.
|
||||
|
||||
---
|
||||
|
||||
# 1. Призначення
|
||||
|
||||
Attention Agent:
|
||||
|
||||
- фільтрує події,
|
||||
- визначає важливість,
|
||||
- блокує шум,
|
||||
- формує дайджести,
|
||||
- підсилює справді важливе,
|
||||
- узгоджує ритм взаємодії між людьми та агентами.
|
||||
|
||||
Він — аналог "ретикулярної формації" спільноти.
|
||||
|
||||
---
|
||||
|
||||
# 2. Проблеми, які він вирішує
|
||||
|
||||
- надлишок сповіщень,
|
||||
- інформаційне перевантаження,
|
||||
- пропущені важливі оновлення,
|
||||
- хаос у каналах,
|
||||
- дублювання повідомлень,
|
||||
- невчасні сигнали,
|
||||
- втому від постійного ping.
|
||||
|
||||
---
|
||||
|
||||
# 3. Види уваги
|
||||
|
||||
Attention Agent працює з трьома видами уваги:
|
||||
|
||||
1. **Миттєва увага**
|
||||
Події, які вимагають негайної реакції.
|
||||
(блокер задачі, критична дія в governance, тривожний сигнал у роботах)
|
||||
|
||||
2. **Периферійна увага**
|
||||
Події, важливі, але не термінові.
|
||||
(новий документ, оновлення задачі, рішення ритуалу узгодження)
|
||||
|
||||
3. **Глибинна увага**
|
||||
Знання, що варто прочитати, але не зараз.
|
||||
(аналітика, звіти, огляди, Co-Memory оновлення)
|
||||
|
||||
---
|
||||
|
||||
# 4. Модель даних (log of events)
|
||||
|
||||
Attention Agent працює поверх подій (`events`):
|
||||
|
||||
```
|
||||
event: {
|
||||
id,
|
||||
team_id,
|
||||
type, // message, task_update, followup, governance, knowledge_update...
|
||||
source, // messenger, tasks, governance, agents...
|
||||
payload, // JSON
|
||||
ts
|
||||
}
|
||||
```
|
||||
|
||||
Він визначає важливість і формує *streams of attention*.
|
||||
|
||||
---
|
||||
|
||||
# 5. Потоки уваги (Attention Streams)
|
||||
|
||||
### 5.1. High-Attention Stream
|
||||
|
||||
- критичні події,
|
||||
- прямі звернення до користувача,
|
||||
- блокери.
|
||||
|
||||
### 5.2. Normal Stream
|
||||
|
||||
- звичайні робочі оновлення.
|
||||
|
||||
### 5.3. Low-Attention Stream
|
||||
|
||||
- знання, аналітика, нові документи,
|
||||
- загальні події.
|
||||
|
||||
---
|
||||
|
||||
# 6. Attention Agent — спроможності
|
||||
|
||||
## 6.1. Фільтрація шуму
|
||||
|
||||
Він аналізує:
|
||||
|
||||
- дублікати,
|
||||
- непотрібні @mention,
|
||||
- спам дій від агентів,
|
||||
- повторювані нагадування.
|
||||
|
||||
Шум приглушується або згруповується.
|
||||
|
||||
## 6.2. Ранжування важливості
|
||||
|
||||
Залежно від:
|
||||
|
||||
- ролі користувача,
|
||||
- поточного контексту,
|
||||
- активного проєкту,
|
||||
- ритуалів узгодження,
|
||||
- стану задач.
|
||||
|
||||
## 6.3. Дайджести
|
||||
|
||||
Формує:
|
||||
|
||||
- огляд дня,
|
||||
- огляд тижня,
|
||||
- огляд проєкту,
|
||||
- огляд каналу.
|
||||
|
||||
## 6.4. Інтелектуальні сигнали
|
||||
|
||||
Наприклад:
|
||||
|
||||
- "Схоже, це важливо саме для тебе".
|
||||
- "Цей документ стосується твого проєкту."
|
||||
- "Тут задача, яку ти раніше коментував."
|
||||
|
||||
## 6.5. Таймінг
|
||||
|
||||
Обирає правильний момент:
|
||||
|
||||
- не вночі,
|
||||
- не в момент великого потоку,
|
||||
- між подіями.
|
||||
|
||||
## 6.6. Підсилення важливого
|
||||
|
||||
Якщо подія має високу важливість:
|
||||
|
||||
- підсвічується,
|
||||
- виноситься у top stream,
|
||||
- дублюється одноразово.
|
||||
|
||||
---
|
||||
|
||||
# 7. Інтеграція з агентами інших модулів
|
||||
|
||||
### Messenger Agent
|
||||
|
||||
- аналізує повідомлення,
|
||||
- визначає важливі ключові слова.
|
||||
|
||||
### Projects Agent
|
||||
|
||||
- сигналить про дедлайни, блокери.
|
||||
|
||||
### Followups Agent
|
||||
|
||||
- генерує ритм.
|
||||
|
||||
### Governance Agent
|
||||
|
||||
- підсвічує ритуали узгодження.
|
||||
|
||||
### Memory Agent
|
||||
|
||||
- працює з подіями знань.
|
||||
|
||||
---
|
||||
|
||||
# 8. Tools (для Runtime Core)
|
||||
|
||||
### 8.1. classify_event
|
||||
|
||||
Визначає важливість події.
|
||||
|
||||
### 8.2. filter_noise
|
||||
|
||||
Зменшує шум, об'єднує дублікати.
|
||||
|
||||
### 8.3. build_digest
|
||||
|
||||
Створює дайджест з групи подій.
|
||||
|
||||
### 8.4. get_user_attention_stream
|
||||
|
||||
Повертає важливі події для конкретної людини.
|
||||
|
||||
### 8.5. suggest_timing
|
||||
|
||||
Підбирає оптимальний час для сповіщення.
|
||||
|
||||
### 8.6. highlight_critical
|
||||
|
||||
Позначає критичні події.
|
||||
|
||||
---
|
||||
|
||||
# 9. Інтеграція з Runtime Core (12)
|
||||
|
||||
```ts
|
||||
const attentionAgentConfig: AgentConfig = {
|
||||
id: "ag_attention_core",
|
||||
teamId: "...",
|
||||
name: "Attention Agent",
|
||||
role: "attention_core",
|
||||
systemPrompt: systemAttentionPrompt,
|
||||
memoryScope: "team",
|
||||
tools: [
|
||||
"classify_event",
|
||||
"filter_noise",
|
||||
"build_digest",
|
||||
"get_user_attention_stream",
|
||||
"suggest_timing",
|
||||
"highlight_critical"
|
||||
]
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 10. UI — візуалізація уваги
|
||||
|
||||
## 10.1. Панель уваги (Attention Panel)
|
||||
|
||||
Правий сайдбар у будь-якому контексті:
|
||||
|
||||
* топ важливих подій,
|
||||
* пропущені сигнали,
|
||||
* критичні оновлення.
|
||||
|
||||
## 10.2. Центр уваги (Attention Hub)
|
||||
|
||||
Окремий екран:
|
||||
|
||||
* `/t/:teamId/attention`
|
||||
|
||||
Тут користувач бачить:
|
||||
|
||||
* "Важливе за сьогодні",
|
||||
* "Критичне зараз",
|
||||
* "Рекомендоване до перегляду".
|
||||
|
||||
## 10.3. Дайджести
|
||||
|
||||
* кнопка "Огляд дня",
|
||||
* кнопка "Огляд тижня".
|
||||
|
||||
## 10.4. Налаштування уваги
|
||||
|
||||
Користувач може обрати:
|
||||
|
||||
* рівень чутливості,
|
||||
* типи подій,
|
||||
* тихі години.
|
||||
|
||||
---
|
||||
|
||||
# 11. API
|
||||
|
||||
### Події
|
||||
|
||||
`GET /events?team_id`
|
||||
`POST /events`
|
||||
|
||||
### Attention Streams
|
||||
|
||||
`GET /attention/stream?user_id`
|
||||
`POST /attention/digest_daily`
|
||||
`POST /attention/digest_weekly`
|
||||
|
||||
---
|
||||
|
||||
# 12. Інструкції для Cursor
|
||||
|
||||
```
|
||||
Implement the Notifications & Attention Agent using:
|
||||
|
||||
- 19_notifications_attention_agent.md
|
||||
- 12_agent_runtime_core.md
|
||||
- 13_agent_memory_system.md
|
||||
- 14_messenger_agent_module.md
|
||||
- 15_projects_agent_module.md
|
||||
- 16_followups_reminders_agent.md
|
||||
- 10_agent_ui_system.md
|
||||
- 05_coding_standards.md
|
||||
|
||||
Tasks:
|
||||
|
||||
1) Create backend models for events and attention streams.
|
||||
|
||||
2) Implement API for events (recording) and attention streams (filtering, ranking).
|
||||
|
||||
3) Register Attention Agent and its tools.
|
||||
|
||||
4) Create UI:
|
||||
|
||||
- Right sidebar "Attention Panel" showing prioritized events.
|
||||
|
||||
- `/t/:teamId/attention` page (Attention Hub).
|
||||
|
||||
- Configuration modal for attention levels.
|
||||
|
||||
5) Integrate with Messenger, Projects, Followups, and Governance Agents.
|
||||
|
||||
6) Implement basic digest generation (daily/weekly).
|
||||
|
||||
Output:
|
||||
|
||||
- file list
|
||||
- diff
|
||||
- summary
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 13. Результат
|
||||
|
||||
Після впровадження цього модуля:
|
||||
|
||||
* спільнота перестає тонути в шумі,
|
||||
* виникає природна структура уваги,
|
||||
* критичні події не губляться,
|
||||
* люди й агенти діють у правильному ритмі,
|
||||
* інформаційне навантаження стає здоровим і екологічним.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user