🥇 Золотые правила работы с Русланом_

Памятка для быстрого старта. Руслан — это агент, а не чат-бот. Относись к нему как к напарнику-разработчику.

14 правил · версия 2.0 · Все уроки →

1. Руслан — не чат! Одна задача за раз

Не пиши ему 3 задачи в одном сообщении. Руслан выполняет одну цель за раз.
Закончил — получил результат — давай следующую.

«Сделай то, потом это, и ещё вот это проверь»
«Создай файл config.yaml с такими настройками» → дождался → «Теперь запусти сервер»


2. Всегда спрашивай перед действием

Руслан — инструмент, он делает что скажут. Если команда опасная (rm -rf, перезапись конфигов, удаление) — он сам спросит.
Но лучшая практика: говори «найди и покажи», прежде чем сказать «удали».

Правило: диагностика → доклад → команда на исполнение.


3. Каждый проект начинай с AGENTS.md

В корне проекта создай AGENTS.md — это инструкция для Руслана. Там пиши:

Руслан автоматически читает AGENTS.md из корня проекта и следует ему.


4. Обязательный костяк проекта (bootstrap)

При старте любого проекта Руслан должен сам создать следующие файлы. Это «скелет», который заставляет агента думать структурно.

📄 CONTEXT.md — текущий статус

Какая фаза, что сделано, что дальше. Руслан обновляет его после каждого этапа.

📄 CONCEPT.md — концепция

Философия проекта. Зачем он нужен, target, главная идея. Это «конституция» — меняется редко.

📄 DECISIONS.md — ключевые решения

Дата + решение + причина. Чтобы не забыть, почему выбрали PostgreSQL, а не MySQL.

📄 DEVELOPMENT_PLAN.md — план разработки

Поэтапный план. Каждый этап — работающий кусочек. Без «пустоты» между этапами.

📄 EVOLUTION.md — эволюция проекта

История изменений по вехам. Как проект рос и трансформировался. Позволяет увидеть прогресс.

📄 ANSWERS.md — ответы сильной модели

Когда подключаешь сильную модель (Claude, Kimi и т.д.) для сложного вопроса — её ответы сохраняются сюда. Теперь это справочник для всей команды.

📄 ESP32_BUYING_GUIDE.md / APPENDICES — железо и ссылки

Гайды по закупке, ссылки, полезные материалы. Отдельно, чтобы не засорять концепцию.

Если начинаешь проект — скажи Руслану:

«Инициализируй проект X: создай CONTEXT.md, CONCEPT.md, DECISIONS.md, DEVELOPMENT_PLAN.md, EVOLUTION.md, ANSWERS.md. Я расскажу идею»

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


5. Git с первого коммита

Любой проект — сразу git init + первый коммит.
Руслан умеет работать с git: коммитить, пушить, смотреть лог.
Если что-то пошло не так — всегда есть откат.

Правило: ни дня без коммита. Если Руслан что-то сделал — пусть закоммитит.


6. Используй скиллы для сервисов

Хочешь работать с GitHub → установи скилл github-pr-workflow
Хочешь работать с документами → установи скилл anthropic-docx
Хочешь работать с Excel → anthropic-xlsx

Команда: ruslan skills search <что нужно>ruslan skills install <id>

Скиллы — это готовые рецепты. Не изобретай велосипед.


7. Фазовый переход (Phase Router)

Любая нетривиальная задача проходит 4 фазы:

  1. Контекст — собери информацию, пойми что есть
  2. План — набросай шаги, покажи человеку
  3. Исполнение — делай по шагам
  4. Проверка — проверь что получилось, покажи результат

Этот цикл называется «фазовый переход» и вшит в скилл fazovyj-perehod.


8. Используй сильные модели для сложных задач

Для кодинга и сложной логики — DeepSeek, Claude, GPT.
Для быстрых ответов — лёгкие модели.
Менять модель можно прямо в диалоге: /model

У Руслана есть делегирование: сложные куски можно отдать суб-агентам с другой моделью.


9. Память — только важное

Руслан помнит тебя между сессиями. Но не забивай память мусором.
В памяти должны быть:

Он сам запоминает то, что нужно. Не дублируй инструкции в каждое сообщение.


10. Мутатор для улучшения промптов

Если Руслан сделал не то, что ты хотел — используй скилл mutator-plus.
Он переформулирует твой запрос так, чтобы агент понял точнее.

Правило: плохой результат = плохой промпт. Уточняй, а не кричи.


11. Не давай голосовые команды на сложные задачи

Голос хорош для «привет» и «как дела».
Для «напиши микросервис на FastAPI» — пиши текстом. Серьёзно.


12. Если Руслан завис или делает не то — останови

Команды экстренной помощи:


13. Cron для регулярных задач

Нужно чтобы Руслан каждый день проверял логи или присылал сводку?
Не проси вручную — поставь cronjob:

«Проверяй каждое утро в 9:00, свободно ли место на диске, и пиши мне в Telegram»

14. Не бойся экспериментировать

Руслан не сломает систему без твоего одобрения.
Пробуй, тестируй, давай обратную связь.
Он учится на своих ошибках — и чем больше ты с ним работаешь, тем лучше он тебя понимает.


📋 Чек-лист первой настройки


Версия 2.0 — «Правило костяка»: любой проект начинается с 6 обязательных файлов.

📘 Другие уроки →