раздел 02

Что писать внутри

Файл инструкций - это краткая «вводная для нового сотрудника». Цель: чтобы агент за минуту понял проект и не делал типовых ошибок.

Команды

Как запустить, собрать, прогнать тесты и линт. Самое полезное - агент не угадывает.

Стиль и соглашения

Язык, форматирование, именование, какие библиотеки использовать, а какие нет.

Структура проекта

Где что лежит, точки входа, важные модули - чтобы агент не искал вслепую.

Ограничения и грабли

Чего НЕ трогать, какие места хрупкие, что ломается. Бережёт от поломок.

Как проверять

Что считать готовым: какие тесты прогнать, как убедиться, что работает.

Контекст проекта

Что это за продукт и пара слов о цели - чтобы решения были в тему.

Пример секций

# Проект
Коротко: что это и для кого.

## Команды
- Запуск: npm run dev
- Тесты: npm test
- Линт: npm run lint

## Стиль
- TypeScript, без any. Имена - camelCase.
- Не добавлять новые зависимости без необходимости.

## Структура
- src/app - страницы, src/lib - логика, src/components - UI.

## Ограничения
- Не трогать billing/* без явной задачи.
- Секреты только в .env, не в коде.

## Проверка
- Перед готовностью: npm run lint и npm test зелёные.