Библиотека шаблонов

Удачный совет, пайплайн или ревью-комиссию не нужно собирать заново в каждом проекте. Библиотека шаблонов — публичный каталог, который пополняют сами пользователи Flownix из любой организации. Устроена она как реестр пакетов npm.

Пакет и версии

Пакет — это неизменное название и автор. Каждая публикация автора добавляет в пакет следующую версию: снимок опубликованной версии харнесса со всем составом — ролями и их инструкциями, шагами и конфигурацией, переходами с условиями, политиками, политикой контекста и схемами входа и выхода.

• Опубликованная версия пакета не меняется. Чтобы что-то исправить, автор публикует новую версию, номера идут подряд.
• Публиковать может любой участник организации проекта харнесса, но только его опубликованную версию, не черновик.
• Новую версию в пакет публикует только его автор.
• Связей нет. Пакет не зависит от исходного харнесса: новые версии, архивация и удаление исходника или проекта его не трогают.

Публикация

В редакторе опубликованного харнесса нажмите «В библиотеку». Выберите «новый пакет» (название 1–120 символов, потом не меняется) или «новая версия моего пакета» и напишите краткое описание версии (1–280 символов).

Предпросмотр показывает ровно то, что увидят все пользователи и получат клоны. Тексты ролей и конфигурация шагов не вычищаются: внутренние пути, slug-и задач и данные проекта уйдут как есть. Публикация требует явного подтверждения раскрытия (confirm_public).

«Мои пакеты» показывают все ваши пакеты и версии. Автор может снять отдельную версию или пакет целиком. Снятое для всех остальных неотличимо от несуществующего, а ранее созданные клоны продолжают работать.

Каталог и клон

Кнопка «Библиотека шаблонов» в списке харнессов открывает каталог: поиск по названию и описанию, фильтр по типу, сортировка по новизне, рейтингу и числу клонов. Карточка пакета показывает все версии и полный состав выбранной.

Клонировать можно любую неснятую версию в проект, где вы состоите. Клон — независимый черновик: одна неопубликованная версия 1, автор — вы, ссылки ролей на политики проекта пустые, участники не назначены. Назначьте участников ролям, проверьте и опубликуйте версию — дальше это обычный харнесс вашего проекта. Новые версии пакета клон не меняют, а правки клона не доходят до пакета.

Оценки и статистика

Любой пользователь, кроме автора, ставит пакету оценку от 1 до 5, может её изменить или снять. Оценка относится к пакету целиком. Каталог и карточка показывают средний балл и число оценок.

Карточка показывает статистику: клоны всего и за 30 дней, число уникальных клонировавших, клоны по версиям и уникальные просмотры. Клоны и просмотры автора не учитываются. Статистика ведётся без связи клона с пакетом, поэтому прогоны клонов в ней не отражаются.

Модерация

Администратор платформы может скрыть любой пакет и вернуть его в каталог. Скрытый пакет недоступен остальным пользователям, существующие клоны не затрагиваются.

Агентам

Всё это доступно через MCP с теми же правилами и кодами ошибок library.*: harness.library_list, harness.library_get, harness.library_clone, harness.library_preview, harness.library_publish, harness.library_my_packages, harness.library_unpublish, harness.library_rate, harness.library_unrate, harness.library_set_hidden. Скилл harness-blueprint ищет подходящий пакет в библиотеке до того, как собирать харнесс с нуля.