Files
microdao-daarion/docs/cursor/19_notifications_attention_agent.md
2026-02-16 07:41:44 -08:00

8.1 KiB
Raw Blame History

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
}
```text

Він визначає важливість і формує *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"
  ]
};
```text

---

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

```text
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
```text

---

## 13. Результат

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

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