docs/BRAINSTORM-PROJECTS-2026-02-20.md

Брейншторм: Проекты (Projects)

Дата: 2026-02-20

Модель проекта

Поля

• id: UUID
• name: string
• slug: string (уникальный)
• description: text
• repo_urls: string[] (массив — multi-repo!)
• status: active | archived
• created_at, updated_at

Вкладки проекта (UI)

• 📋 Канбан-доска — задачи по статусам
• 💬 Чат проекта — общение команды
• 📊 Дашборд — статистика, прогресс, активность агентов
• ⚙️ Настройки — repo URLs, роли, доступы
• 📁 Файлы — хранилище проекта (не git)
• 📜 Activity feed — лента всех событий

Принятые решения

✅ Steps / Этапы задачи

Подзадачи = полноценные задачи на доске. Этапы = чеклист внутри задачи (прогресс агента, не засоряют канбан).

steps: [
  {title: "Изучить код", done: true},
  {title: "Реализация", done: true},
  {title: "Тесты", done: false}
]

✅ Multi-repo проект

Проект может ссылаться на несколько репозиториев (frontend + backend + docs).

✅ Дашборд проекта

Отдельная вкладка: % выполнения, задачи по статусам, активность.

✅ Activity feed

Лента событий: задачи, комментарии, MR, статусы, агенты.

✅ Архив проектов

Завершённый проект → в архив (не удаляется, скрывается по умолчанию).

✅ Роли в проекте

Per-project: кто owner, кто назначает, кто исполняет.

✅ Кросс-проектные ссылки

Задача в проекте A может ссылаться на задачу в проекте B. "Посмотри как сделано там" или "возьми оттуда код".

✅ Проект без задач

Возможен — просто workspace для файлов и чата.

✅ Онбординг агента

При подключении к проекту — скармливать контекст (docs, README, архитектуру).

✅ Агент создаёт проект

Архитектор может создать проект, заполнить описание, поставить задачи.

✅ Режим уведомлений агента

• listen: all — слышит всё (архитектор, PM)
• listen: mentions — только при @упоминании (тестировщик, специализированные)

✅ Лейблы для matching

Задача имеет лейблы → агент поддерживает лейблы → автоматический matching. Mention в комментариях работает для любого агента независимо от лейблов. Вопрос: лейблы глобальные или per-project — TBD.

❌ Отклонено

• Команда проекта (закреплённые роли) — не нужно
• Бюджет в токенах — нет
• Приватность проектов — агент не трогает чужое
• Правила / environments — описываются в docs проекта
• Шаблон проекта — не нужен
• Forking проектов — не нужен
• Плоский список задач вместо проектов — не нравится