start

name	start
description	Инициализация рабочей сессии. Построить адекватную модель проекта, заземлить её в код, доложить с глубиной по запросу.
allowed-tools	Read Glob Grep Bash
disable-model-invocation	true

Skill: Start Session

Назначение

Построить адекватную модель проекта — правильную по структуре, заземлённую в код, знающую свои границы. Защитить проект, пока модель строится.

Три вида ограничений в этом протоколе — намеренно разной природы:

Вид	Где	Как трактовать
На действия (INVARIANTS.md, production-safety)	в коде/контракте	жёстко — guardrails
На внимание (порядок чтения, две оси памяти)	в этом skill	полезно — структура делает глубину достижимой
На глубину/выход доклада	—	нет таких ограничений — глубина диктуется запросом, не форматом

Никаких «доложи 3–5 строк». Минимум — пол адекватности, потолка нет.

Что делать

1. Прочитать слои памяти — обе оси

Контракты (что должно быть):

Read .claude/ARCHITECTURE.md   (если есть)
Read .claude/INVARIANTS.md     (если есть — нарушения = баг, не предпочтение)

State (что есть сейчас):

Read .claude/SNAPSHOT.md       (точка работы)
Read .claude/BACKLOG.md        (если есть — план Next/Soon/Later)

Если какие-то слои отсутствуют — это OK для старого проекта; в новом v6.2+ — сигнал неполной установки. Не паниковать, продолжить.

2. Прочитать CLAUDE.md

Read CLAUDE.md

3. Заземлить карту в территорию (обязательно)

Метафайлы — это карта, не территория. Если SNAPSHOT/ARCHITECTURE разошлись с кодом, ты унаследуешь неточность вместе со слепыми пятнами и не заметишь этого. Цена заземления — минута, ценность — представление, которому можно верить.

Минимум:

# Хронология
git log --oneline -10
git status --short

# Объём кода/контента по основным каталогам
for d in src lib app scripts chapters lessons modules docs; do
  [ -d "$d" ] && echo "$d: $(find "$d" -type f \( -name '*.py' -o -name '*.ts' -o -name '*.tsx' -o -name '*.js' -o -name '*.sh' -o -name '*.md' \) 2>/dev/null | xargs wc -l 2>/dev/null | tail -1)"
done

# Заглушки и недоделки — где карта обещает функциональность, а в коде TODO
grep -rn "TODO\|FIXME\|stub\|raise NotImplementedError\|pass *#" src/ lib/ app/ scripts/ 2>/dev/null | head -20

Если обнаружишь расхождение «SNAPSHOT/ARCHITECTURE говорят X, но grep/wc показывают Y» — зафиксируй это явно при докладе, не сглаживай.

4. Проверить версию фреймворка (фоново)

grep -m1 'v[0-9]' README.md 2>/dev/null || true

Не блокирует старт.

5. Создать лог сессии

mkdir -p .claude/logs/sessions

Файл .claude/logs/sessions/YYYY-MM-DD_HH-MM.md с начальным состоянием.

6. Доложить — глубина по запросу

Доклад масштабируется под запрос пользователя:

Запрос пользователя	Эталон доклада
«start», «начать», молчаливый старт	Компактно: статус, что было в прошлой сессии, незакрытые задачи из BACKLOG.Next, открытые INVARIANTS, готовность. 5–10 строк.
«разберись с проектом», «хочу убедиться что ты понял», «проанализируй»	Полный аналитический разбор: зачем существует, как устроен (модули/слои/контракты), таблица «карта vs территория» из шага 3, состояние (что сделано/что в работе/что блокирует), риски, что я понимаю и где границы знания. Объём — по теме, не по формату.
Конкретная задача в первой реплике	Состояние + явная связь с задачей: какие INVARIANTS могут быть затронуты, какие слои памяти релевантны, какие подсистемы потребуют чтения кода.

Минимум всегда — пол адекватности. Потолка нет. Если в шаге 3 нашёл расхождения — назвать их прямо.

7. Пометка «карта ≠ территория»

После шагов 1–6 ты знаешь карту проекта, не территорию (код). Перед правкой конкретной подсистемы:

• читай её код (не только метафайлы);
• читай её локальные docs (не только корневые);
• сверяй карту с тем, что увидел в коде.

Опасна не неполнота модели, а ложная уверенность в её полноте.

Чего НЕ делать

• Не показывать содержимое файлов пользователю как сырой дамп
• Не запускать тесты (это /finish)
• Не коммитить автоматически (если есть незакоммиченное — сообщить)
• Не кэпить глубину доклада фиксированным объёмом ради «краткости»
• Не пропускать шаг заземления, даже если SNAPSHOT выглядит свежим
• Не генерировать отдельный ONBOARDING.md — конституция живёт в CLAUDE.md, который харнес автозагружает

После выполнения

Агент готов принимать ТЗ. Если запрос пользователя в первой реплике был «разберись/проанализируй» — он уже исполнен этим skill, и сама первая реплика и есть результат.