Holix Studio
Войти Регистрация
Продуктовые проекты · спецификации · команда

Проекты и задачи
как единый процесс

В Holix Studio продуктовый проект — не просто папка с кодом. Это несколько Git-репозиториев, роли (руководитель, аналитик, разработчик, тестировщик…), доска задач, где каждая задача связана со спецификацией (SDD), база знаний Wiki, поиск по документам и агент с правилами роли. От идеи до архива — в одной среде.

Создать аккаунтВозможностиОткрыть Studio
Несколькорепозиториев
Задача= изменение SDD
Ролиот PM до QA
Доска Черновик → Готово
Агенты Анализ · реализация
Контроль Принятие · доработка · QA
Holix Studio: продуктовый проект, доска задач и несколько репозиториев
Концепция

Что такое продуктовый проект

Режим Проекты в Studio — уровень организации: несколько независимых Git-репозиториев (не один «монорепозиторий»), роли участников, доска задач, где каждая задача связана один к одному с изменением в openspec/, Wiki, поиск по документам и встроенный агент Holix с учётом роли. Личная панель «Мои задачи» собирает назначения по всем проектам.

Продуктовый проект Holix Studio

Несколько репозиториев

У каждого — свой openspec, docs, ветка по умолчанию, клонирование и обновление.

Задача = изменение

Идентификатор вида prefix-N, ветка change/…, артефакты спецификации.

Права по ролям

Проверяются на сервере; интерфейс только показывает доступные действия.

События

Назначение, принятие, доработка — уведомления в Studio, Telegram и MAX.

Старт

Как создать проект

Один раз настраиваете каркас поставки: имя, описание, репозитории и команду. До полноценной работы со спецификациями на корне проекта обычно нужны доменные спеки (openspec/specs/ и config.yaml) — Studio может ограничить функции, пока они не готовы.

Мастер создания проекта

Проекты → Создать

Имя, описание; импорт из уже клонированной папки projects/… при необходимости.

Репозитории

Клон по URL Git или пустой git init в projects/<slug>/…

Участники

Пригласите людей с одной или несколькими ролями (например аналитик + разработчик).

Доменные спеки

Базовые спецификации продукта на корне — до массового создания задач.

Локальное сканирование

Подхватить репозитории, уже лежащие в папке проекта.

Настройки

Метаданные проекта, доступы, связь с организацией при необходимости.

Команда

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

Роли на уровне проекта (можно совмещать). От них зависит, кто создаёт продуктовые задачи, кто правит openspec, кто принимает работу и кто закрывает проверку качества. Маркетолог ограничен документацией; руководитель — только просмотр и сводки.

Роли команды продуктового проекта

Руководитель проекта

Доска, назначение, состав, мета; создание продуктовых задач.

Аналитик

Спецификации openspec, анализ, доработка, назначение; формирование спек.

Разработчик

Принятие, реализация, техзадачи и баги, push ветки. Не правит openspec PM/аналитика — только запрос на доработку.

Тестировщик

Доказательства проверки (успех / отказ / заметка); контроль перехода в «Готово».

Маркетолог

docs/ и marketing — без openspec и путей продуктового кода.

Руководитель (наблюдатель)

Только чтение и сводки; без правок.

DevOps

Операции инфраструктуры (в т.ч. prod-цели запуска) вместе с правами организации.

Процесс

Жизненный цикл задачи

От создания до архива. «Контрольные точки» — решения человека (принятие / доработка, проверка качества). Полный сценарий совпадает со справкой Studio «Процесс: продуктовые задачи».

1

Создать задачу

Руководитель / аналитик · постановка · репозиторий · тип · идентификатор · каркас SDD.

2

Назначить

Статус «ожидает принятия»; уведомление в Studio, Telegram/MAX (не при самоназначении).

3

Принять или доработать

Решение исполнителя: ветка change/… или возврат к формированию спеки.

4

Формирование спеки

Артефакты openspec, агенты анализа; заполнение при реализации заблокировано.

5

Подтверждение спеки

Спека готова к реализации / к принятию в работу.

6

Реализация

Код на ветке, агент проекта, тесты, push.

7

Проверка

Доказательства успех/отказ; контроль «Готово».

8

Готово → Архив

Архив openspec/changes/archive; доска очищается.

Доска

Колонки доски задач

У каждой задачи: название, постановка, тип, идентификатор изменения, репозиторий, ветка, исполнитель, статус спеки, проверка качества и расход токенов, если чат привязан к задаче.

КолонкаСмыслКто действует
ЧерновикСоздана; может не быть исполнителя или полной постановкиРуководитель, аналитик
Формирование спекиПишем и уточняем SDD в openspec/changes/…; агенты анализа; реализация заблокированаАналитик, руководитель, агент
Подтверждение спекиСпека готова к принятию / уже в процессе принятия{ "Исполнитель": "принять или доработать" }
РеализацияКод на ветке change/…; агент, тесты, pushРазработчик / исполнитель
ГотовоЗавершено (часто после проверки); архив SDDТестировщик / руководитель; авто-синхронизация при архиве на диске
Задачи

Как создают и ставят задачи

Доска задач → Новая задача. Укажите название, текст постановки («что сделать» + «готово, когда…»), целевой репозиторий и тип (продукт/фича или техника/баг для разработчиков). Studio выдаёт идентификатор вида {prefix}-{n} и по возможности создаёт каркас изменения SDD в выбранном репозитории.

Доска задач продуктового проекта

Чёткая постановка

Контекст, ограничения, критерии готовности — дешевле доработать постановку, чем переписывать код.

Правильный репозиторий

У каждого репозитория свой openspec — не смешивайте домены.

Тип задачи

Продукт/фича — через руководителя и аналитика; техника/баг — чаще разработчик.

Назначение

После понятной постановки; самоназначение не шлёт уведомления в мессенджеры.

Фильтр «мои задачи»

На доске; панель «Мои задачи» собирает назначения по всем проектам.

Подготовка репозитория

Клон или pull ветки по умолчанию, если локального дерева / openspec ещё нет.

ИИ

Анализ задачи агентами

На ранних колонках (в том числе формирование спеки) можно запускать специализированных агентов анализа: разобрать постановку, предложить риски, зависимости, варианты решения, дополнить proposal и спецификации. Рекомендации собираются и вливаются в openspec. Пока формирование не готово, «дозаполнить SDD в реализации» заблокировано — нельзя перескочить в код без понятной спеки.

Анализ задачи специализированными агентами

Специализированные агенты

Исследование, архитектура, риски — параллельно основному контексту.

Слияние в SDD

Proposal, design, доменные спеки, чеклист задач.

Заполнить снова

Перегенерация артефактов, если постановка изменилась.

Ограничение

Заполнение при реализации блокируется до готовности формирования.

Контроль

Принятие, доработка и уведомления

После назначения статус ожидает принятия. На панели «Мои задачи» карточка выделена жёлтым: исполнитель обязан принять или запросить доработку с комментарием. Принятие создаёт или переключает ветку change/<id>, может подготовить локальный репозиторий и сдвигает к реализации. Доработка возвращает к формированию и уведомляет руководителя и аналитика. Самоназначение не шлёт Telegram/MAX.

Принятие и доработка на доске

Ожидает принятия

Жёлтая метка — ждать решения исполнителя.

Принять

Ветка change/… · переход к реализации.

Доработать

Комментарий → формирование; события в проекте.

Уведомления

Входящие в Studio; Telegram/MAX, если привязаны.

Мои задачи

Непринятые сверху по всем проектам.

Правило для разработчика

Не править openspec PM/аналитика — только запрос на доработку.

Реализация

Работа над задачей

В колонке Реализация исполнитель работает в оболочке проекта: редактор, терминал, браузер, Git, Docker — и агент проекта с правилами роли (в контексте — имя проекта, ваши роли, активная задача). Сначала Wiki и поиск по документам, потом «архитектура из головы». Работайте на ветке изменения; push — для ревью. Чат можно привязать к задаче для учёта расхода токенов.

Реализация задачи с агентом в Studio

Агент проекта

Правила роли и жёсткие ограничения в каждом сообщении.

Дисциплина веток

Только change/&lt;id&gt;; push, когда готово.

Wiki и поиск

Переиндексация и запросы по docs перед крупной архитектурой.

Среда запуска

Терминал, процессы, Docker local/remote, превью и share-ссылки.

Техника и баги

Разработчики могут заводить техзадачи в рамках ролей.

Расход

Токены чата, привязанного к задаче.

Качество

Проверка, «Готово» и архив

Тестировщик прикрепляет доказательства (успех / отказ / заметка). Если в команде есть тестировщик, переход в готово может требовать успеха и evidence. Завершение и архив переносят изменение SDD в openspec/changes/archive. Если изменение уже в архиве на диске, Studio может автоматически синхронизировать задачу в «готово».

Проверка качества и архив SDD

Доказательства

Успех / отказ / заметка на карточке.

Контроль «Готово»

Без тихого закрытия, если проверка обязательна.

Архив

openspec archive · чистая доска.

Ответственность

Кто за что отвечает

О — ответственный · У — утверждает · К — консультирует · И — информирован

ШагРуководительАналитикРазработчикТестировщик
Создание / спекиУ / ООИИ
НазначениеОО——
Принятие + веткаИИО—
Реализация + pushИКОИ
ПроверкаИИКО
Готово / архивУККО / У
Знания

Wiki, поиск и агент в проекте

Wiki показывает markdown: docs/**, корневые *.md (продуктовый openspec — не основное дерево docs). Действие агента docs-from-specs может генерировать документы; CHANGELOG — только дополнение. Переиндексация и запрос — поиск по репозиториям проекта (при настройке сервера — и векторный поиск). Сообщения агенту включают имя проекта, ваши роли, активную задачу и жёсткие правила.

Wiki и документация проекта

Wiki

Документация рядом с кодом, не «файл на потом».

Поиск

По документам и репозиториям проекта.

Агент с учётом роли

Не выходит за права роли.

Лента событий

Назначение, принятие, доработка — в реальном времени.

Личный фокус

Панель «Мои задачи»

Главная панель Studio — персональный обзор: открытые задачи из всех продуктовых проектов, где вы исполнитель (не «готово» / не в архиве). Непринятые сверху, с жёлтым акцентом. Клик открывает проект и доску. Уведомления: локальный лоток и сервер; назначение — также Telegram/MAX при привязке. Обзор SDD — уровень изменений; полная доска продукта — в «Проектах».

Панель мои задачи

Сначала непринятые

Принять или запросить доработку до тяжёлой реализации.

Все проекты

Все проекты организации, где вы исполнитель.

Мессенджеры

Уведомление только если назначил другой человек.

Чеклист

Быстрый старт команды

Минимальный путь, чтобы процесс заработал от конца до конца.

1. Проект

Несколько репозиториев + роли (включая тестировщика).

2. Доменные спеки

openspec/specs и config.yaml на корне продукта.

3. Задача

Создать → назначить → принять → реализовать → проверить → готово → архив.

4. Мои задачи

Следить за ожидающими принятия.

5. Wiki и поиск

Перед крупной архитектурой — переиндексация и запрос.

6. Мессенджеры

Привязать Telegram/MAX для уведомлений о назначении (не при самоназначении).

Вопросы

Частые вопросы по проектам

Чем проекты отличаются от обычного workspace?

Workspace — песочница профиля. Продуктовый проект — командный контур с несколькими репозиториями, ролями, доской = SDD, Wiki и агентом проекта.

Можно ли один человек с несколькими ролями?

Да. Например аналитик и разработчик. Права суммируются; сервер всё равно проверяет каждое действие.

Что если разработчик не согласен со спекой?

Запрос на доработку с комментарием — назад к формированию. Править openspec руководителя/аналитика напрямую разработчик не должен.

Обязательна ли проверка качества?

Если в команде есть тестировщик, «готово» часто требует доказательств. Без тестировщика процесс проще, но evidence всё равно полезен.

Как агент «знает» задачу?

В оболочке проекта в контекст попадают проект, роли, активная задача и жёсткие правила. Привяжите сессию чата к задаче для учёта расхода.

Где полный сценарий в продукте?

Справка Studio → «Процесс: продуктовые задачи» и «Проекты (продукт)». Эта страница — публичное описание того же процесса.

Запустите поставку продукта в Studio

Создайте организацию, продуктовый проект и первую задачу — от постановки до архива спецификации без разрозненных трекеров.

Создать аккаунтТарифы