Klepa AI
Установить

Лучшие практики работы с Клёпой

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

Как работать с Клёпой эффективно

Клёпа лучше всего работает, когда вы подбираете режим под конкретную задачу. Встроенных режимов четыре: Ask, Plan, Code и Debug. Не решайте всё одним способом: сначала спросите о проекте, затем спланируйте, после кодируйте, а тесты и результат проверяйте в Debug.

Правильный выбор режима уменьшает количество итераций, делает ответы точнее и помогает быстрее довести задачу до рабочего результата.

Режимы и когда их использовать

Ask

Вопросы по проекту и коду

Режим для вопросов и объяснений. Клёпа читает файлы проекта и отвечает, но ничего не редактирует. Удобно начинать с него знакомство с чужим или давно забытым кодом.

Когда использовать:

  • нужно понять структуру проекта или конкретного модуля
  • требуется объяснение, как работает функция, библиотека или API
  • хочется найти, где в коде реализовано нужное поведение

Пример: Спросите в Ask «Опиши проект» или «Где считается итог корзины?» — ответ будет про ваш код.

Plan

План до написания кода

Режим планирования. Клёпа изучает код, задаёт уточняющие вопросы и раскладывает задачу на шаги с конкретными файлами — файлы при этом не меняются.

Когда использовать:

  • нужно продумать структуру новой функции или сервиса
  • требуется сравнить несколько вариантов решения
  • нужно зафиксировать ограничения и допущения

Пример: Сначала получите план в Plan, затем переключитесь в Code для реализации.

Code

Написание и правка кода

Основной режим для написания, изменения и рефакторинга кода. Лучше всего работает, когда задача уже понятна и есть чёткий контекст.

Когда использовать:

  • нужно реализовать готовую спецификацию
  • требуется внести точечные изменения
  • нужно отрефакторить участок кода без смены логики

Пример: После плана и уточнений переключайтесь в Code для реализации конкретных файлов.

Debug

Тесты, ошибки и результат

Режим для поиска причины ошибки. Клёпа запускает тесты или сборку, читает вывод, проверяет гипотезы и только потом вносит минимальное исправление.

Когда использовать:

  • тесты падают или приложение ведёт себя нестабильно
  • нужно найти причину некорректного результата
  • требуется проверить логи, трассировку или окружение

Пример: Если код работает не так, как нужно, — переключайтесь в Debug до внесения новых изменений.

Практические сценарии

Новая функция с нуля

Сначала разберитесь в существующем коде, затем получите план, после этого переходите к реализации и проверьте результат тестами.

  1. Ask
  2. Plan
  3. Code
  4. Debug

Исправление бага в существующем коде

При отладке не начинайте с переписывания. Сначала найдите причину, затем внесите минимальное исправление и прогоните тесты.

  1. Debug
  2. Code
  3. Debug

Крупная задача в несколько этапов

Большую работу удобно вести параллельно: каждую часть — в своём git worktree через Agent Manager, по плану из Plan.

  1. Plan
  2. Agent Manager
  3. Code
  4. Debug

Ключевые выводы

  • Ask для понимания — спрашивайте о проекте до того, как начнёте гадать
  • Plan перед большой задачей — план и ограничения, потом реализация
  • Code для реализации — пишите код только при ясном контексте
  • Debug для качества — тесты, логи и причина ошибки до новых правок
  • Свои режимы для ролей — ревьюер, фронтендер и другие ставятся из Marketplace
  • Меняйте режим по ходу работы — каждый режим решает свою задачу

Готовы применить?

Откройте Клёпу в VS Code и попробуйте подобрать режим под текущую задачу. Marketplace добавит готовые режимы под конкретные роли.

MarketplaceБыстрый старт