96 lines
5.1 KiB
Markdown
96 lines
5.1 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/*.md` и индексу, плюс один, затем
|
||
`git branch --list "phase/<N>-*"`. Занято — следующий. Гонку ловят ветки,
|
||
не индекс: у новой фазы на `main` строки ещё нет.
|
||
|
||
## 3. Документы
|
||
|
||
Как у соседа (`social.md`, `session.md`, `inventory.md`), не новый жанр.
|
||
|
||
`docs/design/<slug>.md`:
|
||
|
||
- шапка: договорённость на срез, не текущий код; ссылки на соседние доки;
|
||
- зачем, что увидит игрок, на какие вопросы отвечает, чего **нет**;
|
||
- «Что меняется в уже принятом» — Было / Стало / Почему;
|
||
- этапы A/B/C…;
|
||
- «Где живёт код»;
|
||
- «Советы, которые стоит принять сразу»;
|
||
- «Заведомо не сейчас»;
|
||
- «Зафиксировано этим разговором».
|
||
|
||
Фазы — как у соседней, не короче бага: Зависимости, Зачем, Задачи, Тесты
|
||
без которых фаза не закрыта, Критерий готовности, Стоп. Галочки все `[ ]`.
|
||
«Тесты…» — контракт для `/phase-review`: каждый пункт станет отдельным
|
||
тестом по Testing policy в `AGENTS.md`.
|
||
|
||
Индекс — новая секция **перед** «Вне очереди», все ⬜, этапы как у 7–9.
|
||
Куда ходят люди — строка в Orientation `AGENTS.md`.
|
||
|
||
Протокол, HTTP, сейв — назвать явно. Версию не бампать: это коммит с кодом.
|
||
🔄 не ставить: фазы ещё никто не взял.
|
||
|
||
## 4. Код
|
||
|
||
Не этот скилл. Дальше — `/phase-orch`, одну фазу — `/phase-work`. Три фазы
|
||
в этот чат не паковать.
|
||
|
||
## Отчёт
|
||
|
||
Номер среза и slug; путь дизайн-дока; фазы списком; что вне среза; какой
|
||
командой начинать код.
|