101 lines
5.7 KiB
Markdown
101 lines
5.7 KiB
Markdown
---
|
|
name: slice-work
|
|
description: >-
|
|
Обсуждает и заводит новый именованный срез: дизайн-док, фазы, строка в
|
|
индексе. Используй при «новый срез», «заведи срез», «спланируй срез»,
|
|
«обсуди срез», «slice-work». Не пишет код. Не для мелкого DX и склейки
|
|
(/side-work), бага (/bug-work), одной фазы (/phase-work), волны уже
|
|
стоящего среза (/phase-orch) и ревью (/phase-review).
|
|
---
|
|
|
|
# Новый срез
|
|
|
|
Полноценный кусок игры: свой номер, свой дизайн-док, этапы, после каждого
|
|
можно остановить школу целой. Это не дырка и не DX — то `/side-work`. Код
|
|
не писать: после документов — `/phase-orch` или `/phase-work`.
|
|
|
|
«Обсуди и сделай» здесь — согласовать и **записать документы**, не реализовать
|
|
срез в этом чате.
|
|
|
|
## Когда это
|
|
|
|
Прочитай оглавление `docs/phases/README.md` (не индексы всех срезов),
|
|
`docs/bugs/README.md`, инварианты в `AGENTS.md` и **только** дизайн-доки,
|
|
на которые срез опирается.
|
|
|
|
- Уже чья-то фаза в индексе — скажи и отдай `/phase-work`.
|
|
- Регрессия уже сделанного — `/bug-work`.
|
|
- Склейка живых систем, одна кнопка, DX — `/side-work` в «Вне очереди».
|
|
- «Веди срез» про уже стоящие ⬜ — `/phase-orch`, не этот скилл.
|
|
- «Проверь срез» — `/phase-review`.
|
|
|
|
Живой срез с открытыми ⬜ не дописывай, пока не попросили явно. Следующий
|
|
номер — после последнего именованного; «Вне очереди» номер среза не занимает.
|
|
|
|
## 1. Обсуждение
|
|
|
|
Два–пять вопросов, два–три варианта, **рекомендация обязательна**. Спросить
|
|
форму среза:
|
|
|
|
- что увидит и сделает игрок;
|
|
- протокол / HTTP / сейв;
|
|
- какой инвариант;
|
|
- этапы, и можно ли остановиться посередине целой школой;
|
|
- чего в срезе **нет**;
|
|
- на каких срезах стоит;
|
|
- ваниль или отдельный пак.
|
|
|
|
«Ок», «делай», «как рекомендуешь» — согласие. Молчание — нет. Соседнее
|
|
«заодно» в отчёт, не в объём.
|
|
|
|
Покажи черновик: номер, этапы, фазы одной строкой, Стоп. Файлы — после
|
|
согласия, не до.
|
|
|
|
## 2. Номера
|
|
|
|
Срез: максимум именованного в индексе, плюс один.
|
|
|
|
Фазы: максимум по именам `docs/phases/*/<NN>-*.md` (не README, не reviewed),
|
|
плюс один, затем `git branch --list "phase/<N>-*"`. Занято — следующий.
|
|
Гонку ловят ветки, не индекс: у новой фазы на `main` строки ещё нет.
|
|
|
|
## 3. Документы
|
|
|
|
Как у соседа по папке (`09-social/`, `08-session/`, `07-inventory/`), не новый жанр.
|
|
|
|
Папки: `docs/design/<NN>-<slug>/` и `docs/phases/<NN>-<slug>/`. NN — номер
|
|
среза с ведущим нулём (`11-…`). «Вне очереди» номер среза не занимает.
|
|
|
|
`docs/design/<NN>-<slug>/<slug>.md` (если доков несколько — как у `01-shell/`):
|
|
|
|
- шапка: договорённость на срез, не текущий код; ссылки на соседние доки;
|
|
- зачем, что увидит игрок, на какие вопросы отвечает, чего **нет**;
|
|
- «Что меняется в уже принятом» — Было / Стало / Почему;
|
|
- этапы A/B/C…;
|
|
- «Где живёт код»;
|
|
- «Советы, которые стоит принять сразу»;
|
|
- «Заведомо не сейчас»;
|
|
- «Зафиксировано этим разговором».
|
|
|
|
Фазы — `docs/phases/<NN>-<slug>/<M>-<phase-slug>.md`, как у соседней, не короче
|
|
бага: Зависимости, Зачем, Задачи, Тесты без которых фаза не закрыта, Критерий
|
|
готовности, Стоп. Галочки все `[ ]`. «Тесты…» — контракт для `/phase-review`:
|
|
каждый пункт станет отдельным тестом по Testing policy в `AGENTS.md`.
|
|
|
|
Индекс среза — `docs/phases/<NN>-<slug>/README.md` с таблицей фаз, все ⬜,
|
|
этапы как у 7–9. В общий `docs/phases/README.md` — **одна строка** в таблицу,
|
|
без копипасты фаз. Куда ходят люди — строка в Orientation `AGENTS.md`.
|
|
|
|
Протокол, HTTP, сейв — назвать явно. Версию не бампать: это коммит с кодом.
|
|
🔄 не ставить: фазы ещё никто не взял.
|
|
|
|
## 4. Код
|
|
|
|
Не этот скилл. Дальше — `/phase-orch`, одну фазу — `/phase-work`. Три фазы
|
|
в этот чат не паковать.
|
|
|
|
## Отчёт
|
|
|
|
Номер среза и slug; путь дизайн-дока; фазы списком; что вне среза; какой
|
|
командой начинать код.
|