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
339
docs/cursor/16_followups_reminders_agent.md
Normal file
339
docs/cursor/16_followups_reminders_agent.md
Normal file
@@ -0,0 +1,339 @@
|
||||
# 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
|
||||
})
|
||||
```
|
||||
|
||||
### 6.2. create_reminder
|
||||
|
||||
```
|
||||
create_reminder({
|
||||
user_id,
|
||||
message,
|
||||
schedule
|
||||
})
|
||||
```
|
||||
|
||||
### 6.3. check_task_status
|
||||
|
||||
```
|
||||
check_task_status(task_id)
|
||||
```
|
||||
|
||||
### 6.4. ask_for_update
|
||||
|
||||
```
|
||||
ask_for_update(task_id, assignee)
|
||||
```
|
||||
|
||||
### 6.5. daily_digest
|
||||
|
||||
```
|
||||
daily_digest(project_id | team_id)
|
||||
```
|
||||
|
||||
### 6.6. weekly_review
|
||||
|
||||
```
|
||||
weekly_review(project_id | team_id)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 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"
|
||||
]
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 11. Інструкції для Cursor
|
||||
|
||||
Приклад промта:
|
||||
|
||||
```
|
||||
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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 12. Результат
|
||||
|
||||
Після впровадження Followup Agent:
|
||||
|
||||
* microDAO має власного "агента-організатора ритму",
|
||||
* задачі й домовленості ніколи не губляться,
|
||||
* наявна здатність до самодисципліни та самонагляду,
|
||||
* spільнота працює природно, без формальних таблиць чи менеджерів.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user