Files
microdao-daarion/docs/cursor/16_followups_reminders_agent.md
2026-02-16 07:40:07 -08:00

8.8 KiB
Raw Blame History

16 — Follow-ups & Reminders Agent (MicroDAO)

Агент-нагадувань, ритму та повторних дій у MicroDAO

Агент Follow-ups & Reminders (далі — Followup Agent) відповідає за ритм роботи, дисципліну задач, таймінг і "догляд" за станом спільноти та проєктів. Він є природним продовженням Projects Agent і Messenger Agent, але має власну функціональність і власну памʼять.


1. Ідея

Followup Agent — це:

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

Його головна функція — перетворювати хаотичний чат → впорядкований потік дій.


2. Ролі агентів у модулі

2.1. Followup Agent (основний)

Роль: "followups_core"

Він:

  • відстежує дедлайни,
  • нагадує виконавцям,
  • створює follow-ups із діалогів,
  • пропонує зміни статусів задач,
  • робить щоденні/тижневі огляди.

2.2. Personal Reminder Agent (опційний)

Роль: "personal_reminder"

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

3. Документи, які породжує Followup Agent

Цей агент може автоматично створювати:

  1. Follow-up — коротка дія:

    • "З'ясувати статус задачі X"
    • "Перевірити, чи готовий документ"
    • "Написати у канал #design про оновлення макету"
  2. Нагадування:

    • одноразові,
    • повторні (щодня/щотижня).
  3. Запити до виконавців:

    • "Чи потрібна допомога зі задачею?"
    • "Статус задачі лишається незмінним уже 3 дні."
  4. Огляди стану:

    • щоденний digest,
    • тижневий огляд,
    • огляд ризиків.

4. Logics — коли агент активується

4.1. Фрази-тригери в чатах

Якщо хтось пише:

  • "Нагадай мені завтра…"
  • "Скажи через два дні…"
  • "Через годину пінгани мене…"
  • "Слухай, перевір статус задачі…"
  • "Хай мені хтось нагадає про це в понеділок."

Followup Agent:

  • перехоплює,
  • уточнює (якщо потрібно),
  • створює нагадування або follow-up.

4.2. Активність задач

Followup Agent постійно моніторить:

  • задачі без оновлень (X днів),
  • задачі з дедлайнами,
  • блокери,
  • задачі без призначених виконавців.

4.3. Розмови у каналах

Якщо в чаті виникає невирішеність:

  • "Хтось має уточнити це у дизайну."
  • "Хто відповідає за цей файл?"
  • "Було б добре перепровірити після дзвінка."

Agent пропонує:

"Створити follow-up для цього?"


5. Інтеграція з Projects Agent

Followup Agent працює разом з Projects Agent:

  • Якщо створюється задача → Followup Agent аналізує дедлайн і встановлює ритм нагадувань.
  • Projects Agent створює структуру задач → Followup Agent тримає їхній статус живим.
  • Projects Agent відповідає за створення задач → Followup Agent відповідає за виконання, контроль і ритм.

6. Tools (для інтеграції з Runtime Core)

Список інструментів, які Followup Agent використовує у форматі 12_agent_runtime_core.md:

6.1. create_followup

create_followup({
project_id?,
task_id?,
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)

Followup Agent активно використовує памʼять:

### Short-Term Memory

- контекст діалогу, де користувач дає інструкцію.

### Mid-Term Memory

- записи про:

  - виконання/невиконання нагадувань,
  - найбільш часті follow-up патерни,
  - типові проблеми.

### Long-Term Memory

- факти, як от:

  - "Команда працює в ритмі щоденних коротких оглядів."
  - "Треба нагадувати за 24 години до дедлайну."

---

## 8. UI інтеграція

## 8.1. Sidebar / Панель фоллоуапів

- Список активних нагадувань.
- Список активних follow-ups.
- Кнопка "Створити нагадування".

## 8.2. Створення нагадування

- Модалка:

  - "Кому нагадати?" → Людина або собі.
  - "Про що?"
  - "Коли?"

    - natural language ("завтра о 10")
    - або формальні параметри.

## 8.3. Стрічка подій у правій панелі

Followup Agent постійно додає записи:

- "Нагадування заплановано…"
- "Буде перевірено статус задачі…"
- "Follow-up створено…"

## 8.4. Взаємодія через чат агентів

Користувач може написати:

- "Зроби мені кілька нагадувань."
- "Хочу огляд дня."
- "Оціні чи є блокери в цьому проєкті."

---

## 9. API

### 9.1. Follow-ups

`GET /followups?team_id`  
`POST /followups`  
`PATCH /followups/:id`

### 9.2. Reminders

`GET /reminders?user_id`  
`POST /reminders`  
`DELETE /reminders/:id`

### 9.3. Digest & Reviews

`POST /digests/daily`  
`POST /digests/weekly`

---

## 10. Agent конфіг у Runtime Core

```ts
const followupAgentConfig: AgentConfig = {
  id: "ag_followups_core",
  teamId: "...",
  name: "Follow-up Agent",
  role: "followups_core",
  systemPrompt: systemFollowupPrompt,
  memoryScope: "team",
  tools: [
    "create_followup",
    "create_reminder",
    "ask_for_update",
    "check_task_status",
    "daily_digest",
    "weekly_review"
  ]
};
```text

---

## 11. Інструкції для Cursor

Приклад промта:

```text
Implement the Follow-ups & Reminders Agent using:

- 16_followups_reminders_agent.md
- 12_agent_runtime_core.md
- 13_agent_memory_system.md
- 15_projects_agent_module.md
- 14_messenger_agent_module.md
- 10_agent_ui_system.md
- 05_coding_standards.md

Tasks:

1) Create data models for followups and reminders.

2) Implement basic API: GET/POST/PATCH for followups and reminders.

3) Register Followup Agent with tools (create_followup, create_reminder, ask_for_update…).

4) Create UI:

   - sidebar list of active reminders,

   - modal for creating reminders,

   - follow-up events in right sidebar.

5) Integrate chat triggers:

   - detect "нагадати", "через", "завтра", "перевір статус" phrases.

   - forward to Followup Agent.

Output:

- files list
- diff
- summary
```text

---

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

Після впровадження Followup Agent:

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