# Брейншторм: Сводный индекс
Дата: 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

### 🔲 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 (кто что сделал)