h-school/.claude/skills/slice-work/SKILL.md

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/*/<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; путь дизайн-дока; фазы списком; что вне среза; какой командой начинать код.