docs/BRAINSTORM-INDEX.md

107 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Брейншторм: Сводный индекс
Дата: 2026-02-20
## Обсуждённые темы
### ✅ Агентная архитектура
📄 `BRAINSTORM-AGENTS-2026-02-20.md`
- Система автономна (работает без Маркова)
- Один Runner binary (picogent), роль = конфиг
- Git workflow с MR, конфликты решает MR owner
- Файлы: гибрид (repo + file storage), доступ через HTTP API
- MCP для tools + Skill fallback
- Чат = лента событий (люди + агенты + системные)
- Checkpoint pattern для "глухого агента"
- Референсы: MetaGPT (промпты ролей), Claude Flow (claims)
### ✅ Задачи (Tasks)
📄 `BRAINSTORM-TASKS-2026-02-20.md`
- Поля: priority, labels, parent_id, depends_on, reviewer, type
- Свободные переходы статусов (любой → любой)
- Комментарии с mentions, threads, голосовые
- Агент может отклонить задачу
- Автообнаружение блокеров
- **Подзадачи vs Этапы**: подзадачи на доске, этапы внутри задачи
### ✅ Проекты (Projects)
📄 `BRAINSTORM-PROJECTS-2026-02-20.md`
- Вкладки: канбан, чат, дашборд, настройки, файлы, activity feed
- Multi-repo (массив repo_urls)
- Кросс-проектные ссылки
- Архив, проект без задач
- Онбординг агента, listen modes, label matching
### ✅ Picogent — агент-исполнитель
📄 Репо: `team-board/picogent`
- In-process agent loop (Pi Agent Core)
- Dual transport: HTTP + WebSocket
- Skills, sessions, sandbox, directory mode
- **Заменяет runner/** — более зрелая реализация
## Темы для обсуждения (не обсуждены)
### 🔲 Агенты (модель, роли, permissions)
- Регистрация и жизненный цикл
- Роли: owner, agent, bridge, observer
- Permissions: send_messages, create_tasks, assign_tasks...
- Состояния: online, offline, busy, error
- Heartbeat и мониторинг
- Auto-assign по capabilities + labels
### 🔲 Чаты
- Lobby (глобальный), project chat, task comments
- Как связаны (или не связаны) эти три типа
- Форматирование, markdown, code blocks
- Голосовые сообщения в чате
- Реакции на сообщения (emoji)
- Threads в чате (не только в комментариях)
### 🔲 Файловое хранилище
- Upload/download API
- Структура: per-project директории
- Связь с git repos
- Превью файлов (images, code)
- Версионирование (или нет?)
### 🔲 Telegram Bridge
- Один бот связывает Team Board ↔ Telegram группу
- Форматирование сообщений с именем отправителя
- Какие события пробрасывать
- Голосовые через Thoth
### ✅ Протокол Picogent ↔ Tracker
📄 `BRAINSTORM-PROTOCOL-2026-02-20.md`
- WS = real-time (события push + чат сообщения)
- REST = все мутации через MCP tools
- Router разделяет: "в промпт" vs "internal"
- Listen modes: all vs mentions-only
- Prompt guidelines для работы с задачами и коммуникации
### 🔲 WebSocket протокол v2 (реализация)
- Синхронизация picogent WS-протокола с tracker
- Auth, event dispatch, ack на стороне tracker
- Room subscriptions для агентов
### 🔲 MCP Tools для Tracker
- create_task, take_task, update_task, send_message
- list_tasks, get_task, upload_file
- Skill fallback для моделей без MCP
### 🔲 Web UI
- Task detail view (описание, комментарии, steps, attachments)
- Agent management (создание, настройки, мониторинг)
- Dashboard проекта
- Настройки проекта
### 🔲 CI/CD и деплой
- Как деплоить picogent (systemd? docker?)
- Автоматический restart при падении
- Логирование и мониторинг
- Scaling (несколько агентов одного типа)
### 🔲 Безопасность
- Что агент может/не может делать
- Allowed paths vs полный доступ
- Rate limiting
- Audit log (кто что сделал)