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 -13
View File
@@ -19,8 +19,9 @@ description: >-
## Когда это
Прочитай `docs/phases/README.md`, `docs/bugs/README.md`, инварианты в
`AGENTS.md` и соседние дизайн-доки.
Прочитай оглавление `docs/phases/README.md` (не индексы всех срезов),
`docs/bugs/README.md`, инварианты в `AGENTS.md` и **только** дизайн-доки,
на которые срез опирается.
- Уже чья-то фаза в индексе — скажи и отдай `/phase-work`.
- Регрессия уже сделанного — `/bug-work`.
@@ -54,15 +55,18 @@ description: >-
Срез: максимум именованного в индексе, плюс один.
Фазы: максимум по `docs/phases/*.md` и индексу, плюс один, затем
`git branch --list "phase/<N>-*"`. Занято — следующий. Гонку ловят ветки,
не индекс: у новой фазы на `main` строки ещё нет.
Фазы: максимум по именам `docs/phases/*/<NN>-*.md` (не README, не reviewed),
плюс один, затем `git branch --list "phase/<N>-*"`. Занято — следующий.
Гонку ловят ветки, не индекс: у новой фазы на `main` строки ещё нет.
## 3. Документы
Как у соседа (`social.md`, `session.md`, `inventory.md`), не новый жанр.
Как у соседа по папке (`09-social/`, `08-session/`, `07-inventory/`), не новый жанр.
`docs/design/<slug>.md`:
Папки: `docs/design/<NN>-<slug>/` и `docs/phases/<NN>-<slug>/`. NN — номер
среза с ведущим нулём (`11-…`). «Вне очереди» номер среза не занимает.
`docs/design/<NN>-<slug>/<slug>.md` (если доков несколько — как у `01-shell/`):
- шапка: договорённость на срез, не текущий код; ссылки на соседние доки;
- зачем, что увидит игрок, на какие вопросы отвечает, чего **нет**;
@@ -73,13 +77,14 @@ description: >-
- «Заведомо не сейчас»;
- «Зафиксировано этим разговором».
Фазы — как у соседней, не короче бага: Зависимости, Зачем, Задачи, Тесты
без которых фаза не закрыта, Критерий готовности, Стоп. Галочки все `[ ]`.
«Тесты…» — контракт для `/phase-review`: каждый пункт станет отдельным
тестом по Testing policy в `AGENTS.md`.
Фазы — `docs/phases/<NN>-<slug>/<M>-<phase-slug>.md`, как у соседней, не короче
бага: Зависимости, Зачем, Задачи, Тесты без которых фаза не закрыта, Критерий
готовности, Стоп. Галочки все `[ ]`. «Тесты…» — контракт для `/phase-review`:
каждый пункт станет отдельным тестом по Testing policy в `AGENTS.md`.
Индекс — новая секция **перед** «Вне очереди», все ⬜, этапы как у 7–9.
Куда ходят люди — строка в Orientation `AGENTS.md`.
Индекс среза — `docs/phases/<NN>-<slug>/README.md` с таблицей фаз, все ⬜,
этапы как у 7–9. В общий `docs/phases/README.md`**одна строка** в таблицу,
без копипасты фаз. Куда ходят люди — строка в Orientation `AGENTS.md`.
Протокол, HTTP, сейв — назвать явно. Версию не бампать: это коммит с кодом.
🔄 не ставить: фазы ещё никто не взял.