feat: default locale Russian, geo determines language for other countries
- localization-svc: defaultLocale ru, resolveLocale only by geo - web-svc: DEFAULT_LOCALE ru, layout lang=ru, embeddedTranslations fallback ru - countryToLocale: default ru when no country or unknown country Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
home
120
.cursor/rules/agents-guidelines.mdc
Normal file
120
.cursor/rules/agents-guidelines.mdc
Normal file
@@ -0,0 +1,120 @@
|
||||
---
|
||||
description: Инструкции для AI-агента — production-стандарты, качество кода, CONTINUE.md
|
||||
alwaysApply: true
|
||||
---
|
||||
ВАЖНО! ДЕЛАЕМ ВСЕ ДЛЯ ПРОДАКШЕНА РАБОЧЕЕ НА ПРОДАКШЕНА!!!! НЕТ НИКАКИХ ЛОКАЛЬНЫХ ДОРАБОТОК РАЗРАБОТОК ДЕВ СРЕДЫ!!!!!!!!! И НЕ ДЕЛАЙ ДЕВ СРЕДУ!!!! ЭТО ПРОДАКШЕН!!!! ЕСЛИ В КОДЕ УВИДИШЬ ГДЕТО ДЕВ СРЕДУ ЭТО ОСТАТКИ СТАРОЙ ЛОГИКИ ПЕРЕВОДИ ЕЕ НА ПРОДАКШЕН ЕСЛИ НУЖНО УДАЛЯЙ!!!
|
||||
|
||||
ДЕПЛОЙ: только Docker + Kubernetes (локальный K3s на машине). Никакого npm publish, registry push, Vercel, remote VPS. ./deploy/k3s/deploy.sh — единственный способ деплоя.
|
||||
|
||||
|
||||
# Инструкции для AI-агента
|
||||
|
||||
## Старт сессии
|
||||
|
||||
**Сначала проверь `CONTINUE.md`** в корне проекта. Если файл есть — начни с недоделок из него, затем бери новую задачу пользователя. В конце добавь что нужно доработать и что недоделал в рамках одного прохода генерации.
|
||||
|
||||
---
|
||||
|
||||
## Общий принцип
|
||||
|
||||
**Не MVP, а production.** Каждая задача выполняется полностью, как для enterprise-продукта. Никаких заглушек, TODO и «сделаем потом». ИПОЛЬЗУЙ ТОЛЬКО БЕСТ ПРАКТИКИ и сервисную архитектуру с переиспользованием компонентов.
|
||||
|
||||
---
|
||||
|
||||
## 1. Завершённость задач
|
||||
|
||||
- Перед завершением: проверь, что **все** части задачи сделаны. Чеклист обязателен.
|
||||
- Если задача «добавить X» — значит: код, типы, обработка ошибок, edge cases.
|
||||
- Контекстное окно ограничено — всё за один проход нереально. **Обязательно документируй недоделки** (см. раздел 7).
|
||||
- После правок — пройдись по связанным файлам: импорты, экспорты, зависимости.
|
||||
|
||||
---
|
||||
|
||||
## 2. Качество кода
|
||||
|
||||
- **TypeScript:** строгая типизация. Не `any`. Явные типы для параметров и возвращаемых значений.
|
||||
- **Стиль:** следуй существующему коду в проекте. Используй Prettier/ESLint.
|
||||
- **Именование:** чёткие, понятные имена. `handleSubmit`, а не `doStuff`.
|
||||
- **Структура:** логика в отдельных модулях, UI — в компонентах. Избегай «god functions».
|
||||
|
||||
---
|
||||
|
||||
## 3. Обработка ошибок
|
||||
|
||||
- Каждый API route: try/catch, понятные сообщения об ошибках.
|
||||
- Внешние сервисы: таймауты, retry, fallback где уместно.
|
||||
- Пользователь должен видеть понятное сообщение, не сырой stack trace.
|
||||
|
||||
---
|
||||
|
||||
## 4. Безопасность
|
||||
|
||||
- Входные данные: валидация (Zod и т.п.), никогда не доверять клиенту.
|
||||
- Секреты: только переменные окружения, не в коде.
|
||||
- SQL/запросы: параметризованные запросы, без конкатенации строк.
|
||||
|
||||
---
|
||||
|
||||
## 5. Производительность
|
||||
|
||||
- Компоненты: `useMemo`, `useCallback` где нужно.
|
||||
- API: не тянуть лишние данные, пагинация для списков.
|
||||
- БД: индексы для частых запросов, N+1 избегать.
|
||||
|
||||
---
|
||||
|
||||
## 6. Чеклист перед завершением
|
||||
|
||||
- [ ] Все новые файлы созданы и подключены
|
||||
- [ ] Импорты и экспорты корректны
|
||||
- [ ] Типы указаны, ошибок TypeScript нет
|
||||
- [ ] Обработка ошибок добавлена
|
||||
- [ ] Нет `console.log`, `TODO`, заглушек
|
||||
- [ ] Проверены связанные компоненты/роуты
|
||||
- [ ] Нет поломанного существующего функционала
|
||||
|
||||
---
|
||||
|
||||
## 7. Файл недоделок (CONTINUE.md)
|
||||
|
||||
Когда контекст заканчивается или задача не завершена — **записывай в `CONTINUE.md`** в корне проекта. Следующая генерация читает его первой и продолжает с этого места.
|
||||
|
||||
### Формат файла
|
||||
|
||||
```markdown
|
||||
# Недоделки — начать отсюда
|
||||
|
||||
## Задача (исходный запрос)
|
||||
[кратко что хотел пользователь]
|
||||
|
||||
## Сделано
|
||||
- [список файлов и изменений]
|
||||
- [что уже работает]
|
||||
|
||||
## Осталось сделать (в порядке приоритета)
|
||||
1. [конкретное действие] — файл `src/path/file.ts`, строка ~X
|
||||
2. [следующее действие] — файл `path/to/other.ts`
|
||||
3. [ ] Добавить обработку ошибок в route X
|
||||
4. [ ] Проверить импорты в компоненте Y
|
||||
|
||||
## Контекст для продолжения
|
||||
- Изменённые файлы: `file1.ts`, `file2.tsx`
|
||||
- Зависимости: компонент A использует B из `lib/B.ts`
|
||||
```
|
||||
|
||||
### Правила ведения
|
||||
|
||||
- **Перед завершением сессии:** если что-то не доделано — обнови CONTINUE.md. Не полагайся на память.
|
||||
- **В начале новой сессии:** если есть CONTINUE.md — прочитай его и начни с «Осталось сделать». Не начинай задачу с нуля.
|
||||
- **Каждый пункт** — конкретный, с путём к файлу. Не «доделать», а «добавить try/catch в `api/chat/route.ts`».
|
||||
- **После полного завершения** — очисти или удали CONTINUE.md, чтобы не путать следующие задачи.
|
||||
|
||||
---
|
||||
|
||||
## 8. Запреты
|
||||
|
||||
- Не оставлять недоделанную реализацию без записи в CONTINUE.md
|
||||
- Не использовать `any` без крайней необходимости
|
||||
- Не коммитить закомментированный код
|
||||
- Не забывать про loading и error states в UI
|
||||
- Не игнорировать accessibility (a11y) для интерактивных элементов
|
||||
Reference in New Issue
Block a user