Update AGENTS.md and various SKILL.md files to improve documentation structure, clarify design phase references, and ensure consistency in file paths. Adjust links to design documents for better navigation and organization across phases.
This commit is contained in:
@@ -21,10 +21,11 @@ Memory — один раз или без неё; stash с пометкой portr
|
||||
|
||||
Репо: <корень>. Сливать только в основном дереве, и только если оно уже на
|
||||
main (не checkout ветки пользователя bug/…).
|
||||
Фаза: docs/phases/<файл>.md
|
||||
Дизайн среза: docs/design/<файл>.md
|
||||
Фаза: docs/phases/<slice>/<файл>.md
|
||||
Дизайн среза: docs/design/<slice>/<файл>.md
|
||||
Инварианты: AGENTS.md
|
||||
Индекс: docs/phases/README.md — эта фаза сейчас ⬜.
|
||||
Индекс: docs/phases/<slice>/README.md — эта фаза сейчас ⬜.
|
||||
Чужие срезы, сводку reviewed.md и оглавление дальше таблицы не читать.
|
||||
|
||||
Соседи (🔄 / параллельно): <номера и чего не трогать>.
|
||||
Стоп фазы: <из её файла>.
|
||||
@@ -32,10 +33,10 @@ Windows Vitest: при падении параллели — `--maxWorkers=1`.
|
||||
|
||||
Застолбить до кода:
|
||||
1. git branch --list "phase/<N>-*" — пусто, иначе стоп (это чужой захват).
|
||||
Занятость: `git show main:docs/phases/README.md`, не рабочую копию IDE.
|
||||
Занятость: `git show main:docs/phases/<slice>/README.md`, не рабочую копию IDE.
|
||||
2. git branch phase/<N>-<slug> main
|
||||
От **main**, не от HEAD (HEAD часто bug/…). Не checkout основного дерева.
|
||||
3. 🔄 в README **на main**, отдельный коммит только этой строки.
|
||||
3. 🔄 в индексе среза **на main**, отдельный коммит только этой строки.
|
||||
Дерево уже на main — коммить там. Иначе: worktree add <scratch>/wt-claim-main
|
||||
main, коммит там, worktree remove. В bug/… не коммить и не revert чужое.
|
||||
4. git worktree add <scratch>/wt-phase-<N> phase/<N>-<slug>
|
||||
@@ -46,15 +47,15 @@ Windows Vitest: при падении параллели — `--maxWorkers=1`.
|
||||
Задачи и обязательные тесты — как в файле фазы целиком.
|
||||
Гоняй только проект(ы) из Testing policy в AGENTS.md, `--filter` на новый
|
||||
класс. Весь solution не гонять.
|
||||
Общие файлы (README фаз, protocol.md, AGENTS.md) — точечно.
|
||||
Общие файлы (индекс среза, protocol.md, AGENTS.md) — точечно. Каталог срезов не трогать.
|
||||
HTTP/протокол — docs/protocol.md тем же коммитом; версию сокета не бампить,
|
||||
если фаза этого не требует.
|
||||
|
||||
Слияние по скиллу: убрать worktree, merge/lock (общий: фаза/баг/ревью/side;
|
||||
чужой — ждать, не снимать), merge --no-ff, конфликт README — обе стороны.
|
||||
чужой — ждать, не снимать), merge --no-ff, конфликт индекса среза — обе стороны.
|
||||
Грязный main или дерево не на main — не сливать, не checkout, снять lock,
|
||||
отчёт. Stash сам не делай.
|
||||
✅ в README — последним коммитом ветки, только строка статуса.
|
||||
✅ в индексе среза — последним коммитом ветки, только строка статуса.
|
||||
Не сливай чужие ветки.
|
||||
|
||||
Отчёт: фаза и ветка; задачи; тесты списком; какой проект прогнал; незакрытое; слита ли.
|
||||
@@ -106,7 +107,7 @@ phase-work; stash — только если ниже явно сказано, ч
|
||||
<или:>
|
||||
Грязный main — не stash, снять lock, отчёт.
|
||||
|
||||
Конфликт README — обе стороны. protocol.md — не выкидывать чужие блоки.
|
||||
Конфликт индекса среза — обе стороны. protocol.md — не выкидывать чужие блоки.
|
||||
После успеха: branch -d (не -D), снять lock, worktree remove.
|
||||
Не пушь. HSchool.Server не убивай. Весь solution не гонять: конфликт только
|
||||
в статусе — тесты не нужны; в коде — узкий проект из Testing policy.
|
||||
@@ -122,7 +123,7 @@ phase-work; stash — только если ниже явно сказано, ч
|
||||
Следуй `.claude/skills/phase-review/SKILL.md`. Один проход — только фазы
|
||||
<X>–<Y> (этап <A> среза <имя>), не весь срез и не следующий.
|
||||
|
||||
Свой заголовок в docs/phases/reviewed.md. Чужие разделы журнала не затирай.
|
||||
Свой заголовок в docs/phases/<slice>/reviewed.md. Чужие срезы не открывать.
|
||||
Ветка `git branch review/<slug> main` (от main, не от HEAD).
|
||||
Worktree вне репо: <scratch>/wt-review-<slug> — дальше только его пути.
|
||||
Журнал коммить в этом worktree, не в bug/… пользователя.
|
||||
|
||||
Reference in New Issue
Block a user