add skils
This commit is contained in:
@@ -0,0 +1,95 @@
|
||||
---
|
||||
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; путь дизайн-дока; фазы списком; что вне среза; какой
|
||||
командой начинать код.
|
||||
Reference in New Issue
Block a user