3.2 KiB
3.2 KiB
Правила локальной разработки
Обязательно к прочтению перед началом работы!
Инструменты
MCP серверы
- Serena — для работы с кодом (символьная навигация, редактирование)
- Context7 — для получения актуальной документации по библиотекам
Используй эти инструменты для эффективной работы с кодовой базой.
Правила работы
1. Никогда не запускай сервисы самостоятельно
ЗАПРЕЩЕНО запускать cargo run, cargo build и подобные команды.
Вместо этого попроси пользователя запустить:
Запусти, пожалуйста:
cargo run
2. Тестирование — только ручное
После завершения задачи:
- Опиши сценарии для проверки
- Попроси пользователя проверить вручную
- Дождись фидбека
Формат:
Готово! Проверь, пожалуйста:
1. Открой cargo run
2. понавигируйся в списке чатов кнопками h j k l
3. Нажми Enter для открытия чата
4. Убедись, что чат прогурзился
Напиши, если что-то не работает.
3. Работа поэтапно
Делай работу небольшими итерациями:
-
Один этап = одна логическая единица
- Один endpoint
- Один компонент
- Одна фича
-
После каждого этапа:
- Сообщи что сделано
- Дай сценарий проверки
- Дождись подтверждения
-
Не делай сразу много:
- ❌ Весь CRUD за раз
- ✅ Сначала GET, проверили, потом POST, проверили...
Чеклист перед началом работы
- Прочитал CONTEXT.md
- Прочитал ROADMAP.md (понял текущую фазу)
- Понял задачу
- Готов работать поэтапно
- Помню: не запускаю сервисы сам, прошу пользователя
Пример правильного workflow
Пользователь: Сделай endpoint для получения списка идей
Агент:
1. Читает документацию через Context7 (NestJS, TypeORM)
2. Использует Serena для навигации по коду
3. Создаёт endpoint GET /api/ideas
4. Сообщает:
"Создал endpoint GET /api/ideas.
Запусти backend:
cd backend && npm run dev
Проверь:
curl http://localhost:4001/api/ideas
Должен вернуться пустой массив: { data: [], meta: {...} }"
5. Ждёт фидбек
6. Переходит к следующему этапу