microdao-daarion/docs/cursor/19_notifications_attention_agent.md

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)

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. Результат

Після впровадження цього модуля:

• спільнота перестає тонути в шумі,
• виникає природна структура уваги,
• критичні події не губляться,
• люди й агенти діють у правильному ритмі,
• інформаційне навантаження стає здоровим і екологічним.