Project Kanban Worktrees

Связанные с проектом канбан-ворктри и имена веток.

Метаданные навыка

Источник	Встроенный (установлен по умолчанию)
Путь	skills/software-development/project-kanban-worktrees
Версия	1.0.0
Автор	VibeOS
Лицензия	MIT
Платформы	linux, macos
Теги	kanban, project, worktree, branch, git
Связанные навыки	git-local-workflow, github-pr-workflow

Справочник: полный SKILL.md

к сведению

Ниже приведено полное определение навыка, которое VibeOS загружает при его активации. Это то, что агент видит в качестве инструкций, когда навык активен.

Project Kanban Worktrees

Используйте это при создании канбан-задач, которые должны размещаться в git-ворктри под первоклассным проектом VibeOS. Ядро уже выбирает детерминированную ветку (<project-slug>/<task-id>[-<title>]) и путь к ворктри (<primary-repo>/.worktrees/<task-id>), когда задача привязана к проекту.

Не придумывайте случайные имена веток вида wt/<id>, если проект привязан.

Когда использовать

• Пользователь хочет параллельной работы агента над репозиторием через канбан + ворктри
• Привязка проекта к канбан-доске (bind-board)
• Создание задач, которые должны открывать PR из стабильного имени ветки
• Объяснение, почему рабочая директория агента находится в .worktrees/

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

• Git-репозиторий как основная папка проекта
• Проект зарегистрирован: vibeos project create … / /projects в TUI
• Доска привязана (опционально, но рекомендуется): vibeos project bind-board <project> <board-slug>

Как запустить

1. Убедитесь, что проект существует и основной путь — это git-репозиторий:

vibeos project show <slug>
vibeos project check <slug>

2. Привяжите доску (устанавливает default_workdir доски на основной путь, когда это возможно):

vibeos project bind-board <slug> <board>

3. Создайте задачу с поддержкой ворктри (привязка к проекту + ворктри):

vibeos kanban create "Add login form" \
  --assignee coder \
  --workspace worktree \
  --board <board>

Если у доски установлен default workdir / привязка к проекту, диспетчер создаёт:

Артефакт	Формат
Ветка	<project-slug>/<task-id>-<title-slug>
Директория ворктри	<primary>/.worktrees/<task-id>

Предварительный просмотр имени ветки без создания задачи:

vibeos project branch-name <slug> t_example --title "Add login form"

4. После завершения работы агента используйте git-local-workflow, затем github-pr-workflow, если запрошен PR. Не пушите, если не попросили.

Краткая справка

Цель	Команда
Список проектов / отсутствующих папок	vibeos project list / check
Переключить проект в TUI	/projects
Привязать доску	vibeos project bind-board <proj> <board>
Задача с ворктри	vibeos kanban create … --workspace worktree
Предпросмотр ветки	vibeos project branch-name <proj> <task-id> [--title …]
Явное переопределение ветки	--workspace worktree --branch <name>

Процедура

1. Убедитесь, что основной репозиторий существует на диске (project check).
2. Привяжите доску, если канбан должен наследовать репозиторий как default workdir.
3. Создавайте задачи с --workspace worktree (не просто scratch) для работы с кодом.
4. Предпочитайте, чтобы ядро называло ветку через branch_name_for — передавайте --branch только когда пользователь запросил конкретное имя.
5. Держите тенанты отдельно от именования веток: используйте --tenant для изоляции клиентов; имена веток остаются в рамках проекта.

Подводные камни

• --branch действителен только с --workspace worktree.
• Относительные dir:-воркспейсы отклоняются — используйте абсолютные пути.
• Отсутствие основной папки: активация всё ещё работает в /projects, но настройка cwd/ворктри завершается ошибкой, пока путь не будет смонтирован или добавлен заново.
• Scratch-воркспейсы удаляются при завершении задачи — не используйте их для кода, который должен сохраниться для PR.

Проверка

vibeos project branch-name demo t_abcd --title "ship it"
# → demo/t_abcd-ship-it

vibeos kanban show <task-id>
# workspace_kind=worktree, branch_name=<project-slug>/…