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
+18 -8
View File
@@ -8,8 +8,10 @@
трогали `src/HSchool.Client`. `HSchool.AppHost.Tests` — только HTTP / сокет / хост.
Общее во все промпты: не пушь; `HSchool.Server` не убивай; dev-сервер не
поднимай; `cursor-app-control` не вызывай; memory — один раз или без неё;
stash с пометкой portraits / чужой wip не pop.
поднимай; `GetMcpTools` на `cursor-app-control` не зови (висит). После
`worktree add` можно один `move_agent_to_root` с `rootPath` = путь worktree,
без открытия сервера; иначе все правки — абсолютным путём worktree.
Memory — один раз или без неё; stash с пометкой portraits / чужой wip не pop.
## Разработчик — новый захват ⬜
@@ -30,10 +32,16 @@ Windows Vitest: при падении параллели — `--maxWorkers=1`.
Застолбить до кода:
1. git branch --list "phase/<N>-*" — пусто, иначе стоп (это чужой захват).
2. git branch phase/<N>-<slug>
3. 🔄 в README основного дерева, отдельный коммит только этой строки.
Занятость: `git show main:docs/phases/README.md`, не рабочую копию IDE.
2. git branch phase/<N>-<slug> main
От **main**, не от HEAD (HEAD часто bug/…). Не checkout основного дерева.
3. 🔄 в README **на main**, отдельный коммит только этой строки.
Дерево уже на main — коммить там. Иначе: worktree add <scratch>/wt-claim-main
main, коммит там, worktree remove. В bug/… не коммить и не revert чужое.
4. git worktree add <scratch>/wt-phase-<N> phase/<N>-<slug>
Клиент: npm ci или копия node_modules (не рекурсивно в себя).
5. Дальше только этот worktree: абсолютные пути / working_directory. Корень
IDE не трогать (ни Write, ни git commit).
Задачи и обязательные тесты — как в файле фазы целиком.
Гоняй только проект(ы) из Testing policy в AGENTS.md, `--filter` на новый
@@ -61,12 +69,12 @@ HTTP/протокол — docs/protocol.md тем же коммитом; вер
Следуй `.claude/skills/phase-work/SKILL.md`. Блок «Как застолбить» пропусти.
Фаза: **<N>. <имя>**. Ветка уже есть: **phase/<N>-<slug>**.
Worktree: <путь>/wt-phase-<N> — работай там.
Worktree: <путь>/wt-phase-<N> — работай там (абсолютные пути).
🔄 не сбрасывай и вторую ветку не создавай. `git branch --list "phase/<N>-*"`
не обязан быть пустым — это не гонка.
Не начинай фазу с нуля. Брось MCP (cursor-app-control не звать).
Дочитай незакоммиченное в worktree, не выкидывай его.
Не начинай фазу с нуля. Брось MCP (`GetMcpTools` на cursor-app-control не звать).
Корень IDE / bug/… не трогай. Дочитай незакоммиченное в worktree, не выкидывай его.
Дальше — как обычный разработчик: задачи фазы, тесты по Testing policy
(`--filter`, не весь solution), слияние по скиллу (грязный main / не на
@@ -115,7 +123,9 @@ phase-work; stash — только если ниже явно сказано, ч
<X><Y> (этап <A> среза <имя>), не весь срез и не следующий.
Свой заголовок в docs/phases/reviewed.md. Чужие разделы журнала не затирай.
Ветка review/<slug>, worktree вне репо: <scratch>/wt-review-<slug>.
Ветка `git branch review/<slug> main` (от main, не от HEAD).
Worktree вне репо: <scratch>/wt-review-<slug> — дальше только его пути.
Журнал коммить в этом worktree, не в bug/… пользователя.
Слияние как у phase-work: merge/lock общий, --no-ff, не пушь.
Основное дерево уже на main; не checkout bug/….
Тесты — Testing policy, `--filter`, не весь solution.