docs/BRAINSTORM-INDEX.md

Брейншторм: Сводный индекс

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