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.
ci / server (push) Failing after 3m41s
ci / client (push) Successful in 21s

This commit is contained in:
Leonid Pershin
2026-08-20 12:26:21 +03:00
parent a37a5eb82d
commit 9a6cbff55a
30 changed files with 116 additions and 95 deletions
+18 -14
View File
@@ -22,10 +22,11 @@ description: >-
## 1. Обсуждение
Прочитай `docs/phases/README.md`, `docs/bugs/README.md`, инварианты в
`AGENTS.md` и затронутые дизайн-доки. Это уже чья-то фаза в индексе — скажи
и отдай `/phase-work`. Регрессия уже сделанного — `/bug-work`. Этапы, новый
кусок игры, остановка посередине целой школой — `/slice-work`.
Прочитай оглавление `docs/phases/README.md` (не индексы всех срезов),
`docs/bugs/README.md`, инварианты в `AGENTS.md` и **только** затронутый
дизайн. Это уже чья-то фаза — скажи и отдай `/phase-work`. Регрессия уже
сделанного — `/bug-work`. Этапы, новый кусок игры, остановка посередине
целой школой — `/slice-work`.
Два–пять вопросов, два–три варианта, **рекомендация обязательна**. Спросить
только форму: что увидит игрок; протокол / HTTP / сейв; какой инвариант; одна
@@ -40,23 +41,26 @@ description: >-
**Новый срез** — не этот скилл, [slice-work](../slice-work/SKILL.md).
**Мелкое** (дырка, одна кнопка, DX, склейка живых систем) — фаза в секции
**«Вне очереди»** в конце индекса. Это срез без номера, чтобы не спорить со
следующим именованным. Дизайн `##` в `docs/design/off-queue.md`; файла нет —
заведи с заголовком, зачем он.
**Мелкое** (дырка, одна кнопка, DX, склейка живых систем) — фаза в
`docs/phases/off-queue/`. Это срез без номера, чтобы не спорить со следующим
именованным. Дизайн новой темы — **новый файл**
`docs/design/off-queue/<slug>.md`, не дописывать в чужой файл темы. Строка в
`docs/design/off-queue/README.md`.
Номер фазы: максимум по `docs/phases/*.md` и индексу, плюс один, затем
`git branch --list "phase/<N>-*"`. Занято — следующий. Гонку ловят ветки, не
индекс: у новой фазы на `main` строки ещё нет.
Номер фазы: максимум по именам `docs/phases/*/<NN>-*.md` (не README, не
reviewed), плюс один, затем `git branch --list "phase/<N>-*"`. Занято —
следующий. Гонку ловят ветки, не индекс: у новой фазы на `main` строки ещё нет.
## 3. Документы
Как у соседней фазы, не новый жанр. Каркас тот же: Зависимости, Зачем, Задачи,
Тесты без которых фаза не закрыта, Критерий готовности, Стоп.
Как у соседней фазы в `off-queue/`, не новый жанр. Каркас тот же: Зависимости,
Зачем, Задачи, Тесты без которых фаза не закрыта, Критерий готовности, Стоп.
Файл — `docs/phases/off-queue/<N>-<slug>.md`.
«Тесты…» — контракт для `/phase-review`: каждый пункт станет отдельным тестом
по Testing policy в `AGENTS.md`. Дизайн: зачем; «Было / Стало / Почему», если
меняется принятое; что не входит. Индекс — новая строка, статус ⬜.
меняется принятое; что не входит. Индекс — новая строка в
`docs/phases/off-queue/README.md`, статус ⬜. Общий каталог срезов не трогать.
Протокол, HTTP, сейв — назвать явно. Версию не бампать: это коммит с кодом.