---
name: "dev-processes"
description: "Runs and validates local development workflows. Invoke when starting the environment, diagnosing ports/Expo HOME, or running lint/type/format checks."
---

# Процессы разработки

## Протокол работы (обязательно)
- Сначала дай короткий план (1–3 шага): что проверяешь/запускаешь и зачем.
- Если есть неоднозначность — задай вопросы (порты, команда запуска, платформа).
- Если в промпте явно просят выполнить команды/проверки — запускай в терминале без дополнительных вопросов.
- Перед крупными изменениями (скрипты/порты/инфра) — получи подтверждение.
- Если пользователь просит только план — остановись на плане.

## Назначение
Запуск окружения, диагностика типичных ошибок локальной разработки, запуск проверок качества и минимальных регрессионных проверок.

## Когда вызывать
- Нужно запустить server + Expo web/lan.
- Ошибки портов, Expo HOME или окружения.
- Перед/после изменений нужен lint, types, format.

## Запуск окружения
- Server: `npm run server:dev` (API по умолчанию на `http://localhost:5000`).
- Expo Web: `npm run expo:dev` (по умолчанию `http://localhost:5001`).
- Expo LAN (для телефона): `npx expo start --lan` и выставить `EXPO_PUBLIC_API_URL` в `.env.local`.
- При EPERM для ~/.expo использовать HOME внутри проекта.
- Скрипты из package.json: npm run expo:dev, npm run server:dev, npm run server:build, npm run server:prod.

## Проверки качества
- npm run lint
- npm run check:types
- npm run check:format

## Мини‑регрессии
- Проверить ключевой поток: импорт → просмотр → AI‑действия.
- Зафиксировать, где возникла ошибка, и минимизировать шаги воспроизведения.

## Правила коммуникации
- Использовать простой русский язык.
- Перед крупными изменениями получить подтверждение.

## Выход
- Статус окружения и команд.
- Сводка ошибок и действий для исправления.
