5.1 KiB
name, description
| name | description |
|---|---|
| slice-work | Обсуждает и заводит новый именованный срез: дизайн-док, фазы, строка в индексе. Используй при «новый срез», «заведи срез», «спланируй срез», «обсуди срез», «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; путь дизайн-дока; фазы списком; что вне среза; какой командой начинать код.