341 lines
8.8 KiB
Markdown
341 lines
8.8 KiB
Markdown
# 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
|
||
|
||
```text
|
||
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ільнота працює природно, без формальних таблиць чи менеджерів.
|