Update SKILL documentation for phase and bug workflows. Clarified branch creation commands to specify main instead of HEAD, emphasized the importance of not committing phase changes to the bug tree, and provided detailed instructions for managing worktrees and agent interactions. Enhanced clarity on handling dependencies and worktree paths to prevent conflicts.
ci / server (push) Failing after 3m36s
ci / client (push) Successful in 20s

This commit is contained in:
Leonid Pershin
2026-08-20 10:29:56 +03:00
parent b14d27dd81
commit 9c49c8b3a6
7 changed files with 82 additions and 28 deletions
+13 -3
View File
@@ -49,7 +49,9 @@ N — **одновременные** агенты, не «запусти N и з
## Старт
1. Прочитай `docs/phases/README.md` и `docs/phases/reviewed.md`.
1. Прочитай `docs/phases/README.md` и `docs/phases/reviewed.md`. Если IDE не
на `main` — статусы с `git show main:docs/phases/README.md`, не с рабочей
копии (там может быть чужой 🔄 из бага).
2. Посчитай, сколько ⬜ с **закрытыми** зависимостями (шапка фазы). 🔄 не бери
как новый захват.
3. Проверь `git branch --list "phase/*"` и `review/*` — заявка уже стоит.
@@ -99,6 +101,7 @@ N — **одновременные** агенты, не «запусти N и з
| Пользователь: пауза, только слияние | interrupt разработчикам: коммит WIP **на своей ветке**, не merge, не main. Merge-агентов не трогать |
| Пользователь: последняя волна / остановись | interrupt: добей свою фазу (и merge) и стоп. **Новых** агентов не запускать, в том числе по completion |
| Пользователь: продолжи | снять паузу с WIP-ветки (`resume` с хешем коммита), не начинать фазу с нуля |
| Агент коммитит в `bug/…` / нет worktree | interrupt: стоп в корне IDE, `worktree add` на уже существующую ветку фазы, 🔄 на `main` через `wt-claim-main`. Историю `bug/…` не revert |
Зависимую ⬜ не открывать, пока зависимость 🔄 или лежит неслитой веткой.
@@ -107,8 +110,10 @@ N — **одновременные** агенты, не «запусти N и з
Транскрипт из 1–2 сообщений («читаю скилл» / `GetMcpTools`) при живом агенте
дольше ~15 минут, или тишина после interrupt — **завис**.
1. `resume` + `interrupt`: брось MCP (`cursor-app-control` не звать), не читай
скилл заново, продолжай с ветки/worktree.
1. `resume` + `interrupt`: брось MCP (`GetMcpTools` на `cursor-app-control` не
звать), не читай скилл заново, продолжай с ветки/worktree. Корень IDE не
трогай. Если worktree нет — `git worktree add` на существующую `phase/<N>-*`,
не создавай вторую ветку.
2. Второй раз — старый: «уступи, git не трогай». Новый агент — **продолжение**
того же 🔄: та же ветка и worktree, промпт «замена зависшего». Это не новый
захват ⬜ и не второй автор.
@@ -145,6 +150,10 @@ N — **одновременные** агенты, не «запусти N и з
Замена зависшего — существующая ветка в промпте, не пустой `git branch --list`.
Ветка фазы — `git branch phase/<N>-<slug> main` (не от HEAD). 🔄 только на
`main`: если IDE на `bug/…`, одноразовый worktree `wt-claim-main`, не коммит в
дерево пользователя. После `worktree add` правки — абсолютным путём worktree.
Шаблон: [`worker-prompt.md`](worker-prompt.md).
## Чего не делать
@@ -158,6 +167,7 @@ N — **одновременные** агенты, не «запусти N и з
- `git push`.
- Переставлять чужие 🔄/✅ (замена зависшего 🔄 не трогает: статус тот же).
- Снимать чужой `merge/lock` или `checkout` основного дерева с `bug/…` на `main`.
- Коммитить 🔄 фазы в дерево `bug/…` или править код фазы в корне IDE.
- Заканчивать ответ без списка агентов (ниже).
## Список агентов