Git и стратегия worktree

Git даёт Agent Teams самый сильный review path: narrow diffs, branch visibility, task-scoped changes и более безопасную parallel work.

Выбор стратегии

Strategy	Когда использовать	Tradeoff
Main worktree	Solo work, docs-only edits или один teammate за раз	Просто, но parallel edits могут конфликтовать
Feature branch	Одна team работает над одним coherent change	Чистый review target, но teammates всё ещё делят files
Worktree isolation	Несколько OpenCode teammates могут параллельно менять один repo	Лучше isolation, но merge/review требует дисциплины

Начинайте просто. Включайте worktree isolation, когда parallel edits вероятны, а не потому что каждому task нужен отдельный checkout.

Когда включать изоляцию worktree

Включайте для OpenCode teammates, когда:

• два или больше teammates могут менять один repository одновременно
• task может запускать formatters, code generators или broad tests
• нужно держать branch и diff каждого teammate отдельно
• lead workspace dirty и не должен получать прямые edits

Оставляйте выключенным, когда:

• task read-only
• один teammate владеет всеми edits
• repo не Git-tracked
• нужен runtime path, который не поддерживает этот isolation mode

WARNING

Worktree isolation сейчас применяется к OpenCode members и требует Git-tracked project.

Гигиена веток

Перед parallel work:

git status --short
git branch --show-current

По возможности используйте clean branch. Если main worktree уже содержит user changes, скажите agents не revert unrelated files и держать task scope узким.

Рекомендуемый branch style:

agent/<team-or-task>/<short-purpose>

Примеры:

agent/docs/mcp-guide
agent/review/task-log-filtering
agent/ui/code-review-polish

Процесс ревью

Для isolated worktrees проверяйте diff teammate до merge или apply в main workspace.

1. Убедитесь, что task result comment называет changed scope и verification.
2. Проверьте task diff в review UI.
3. Запросите changes в task, если diff трогает unrelated files.
4. Approve только когда tests или manual checks соответствуют risk.
5. Merge или apply changes осознанно.

Не auto-merge worktree output только потому, что task complete. Completion значит, что agent считает работу ready for review.

Политика разрешения конфликтов

Situation	Action
Два teammates меняют один file	Pause one task или назначьте одного owner для integration
Generated files changed broadly	Требуйте comment с generator и command
Main worktree имеет unrelated changes	Preserve them и review только task-owned changes
Worktree branch diverges	Rebase или merge manually после review, не внутри vague agent task

Пример промпта для задачи

Implement the settings validation fix in your assigned worktree. Keep edits inside src/features/settings and focused tests. Do not touch provider auth or task storage. Post the test command and result before completing the task.

Этот prompt работает, потому что называет allowed area, sensitive boundaries и completion evidence.

Связанные руководства

• Создание команды
• Код-ревью
• Примеры team brief