Hard Coding PRO · Набор для ИИ-агента

Зачем это нужно

Чтобы не объяснять ИИ-агенту одно и то же в каждом чате

Ты несколько часов работаешь с ИИ-агентом и уже объяснил ему: не затирай настройки, делай резервную копию, не проси секреты в чат, проверяй результат.

В текущем чате всё хорошо. Потом открываешь новый — и часть правил приходится объяснять снова.

Живой пример

Агент изменил Telegram-интеграцию и написал: «Готово».

Но сам Telegram он не проверил. Сообщение пользователю не пришло.

Поэтому нам нужна не ещё одна огромная простыня промпта, а понятная система из трёх частей.

Что получится

Три понятных механизма вместо сотни напоминаний

В конце у твоего ИИ-агента будет три понятных механизма: что помнить всегда, какую методичку открыть под конкретную задачу и что автоматически сделать в нужный момент.

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

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

ИИ делает техникускачивает набор, сохраняет резервную копию настроек, аккуратно добавляет новые правила, запускает проверки и диагностирует ошибки.

Три слоя управления ИИ-агентом: Инструкция, Навык и Автодействие — Главная модель урока: три разных механизма вместо одного бесконечного промпта.

Что ставится сейчас

Готовый kit устанавливает 19 Skills, постоянную инструкцию, совместимые hooks/автодействия и проверки. В конце агент задаёт 4 коротких вопроса о тебе, заполняет раздел «Мои данные» и рекомендует 2–3 Skills под твои реальные задачи.

Твоя стартовая фраза: «Установи всё по инструкции, но адаптируй под меня!»

Понять просто

Инструкция, Навык и Автодействие

Представь, что ИИ-агент — это сотрудник.

Часть системы	Простая аналогия	Когда нужна
Инструкция	Постоянные правила сотрудника	Правило должно действовать почти всегда
Навык	Подробная рабочая методичка	Нужен отдельный процесс под конкретную задачу
Автодействие	Автоматическая охрана или реакция	Что-то должно сработать само при событии

Главная ошибка — сложить всё в один огромный файл. Чем больше постоянного текста, тем больше шума и конфликтов.

Самая простая проверка

Должно действовать всегда → ИнструкцияНапример: не говори «готово» без проверки.

Нужен отдельный глубокий процесс → НавыкНапример: полностью проверить выпуск перед публикацией.

Должно сработать само → АвтодействиеНапример: заблокировать чтение секретного файла.

Короткая постоянная инструкция и Навыки, которые подключаются по задаче — Постоянный контекст держим коротким. Глубокие процессы подключаем только когда они нужны.

Что можно создать уже сегодня

Это не только «настройки». Это инфраструктура твоего способа работать

🧠 Память между чатамиНовый чат подхватывает сохранённое состояние проекта и понимает, где остановилась работа.

🛡️ ЗащитаПеред опасным действием автоматика блокирует чтение секретного файла или разрушительную команду.

✅ ПриёмкаНавык заставляет проходить полную проверку и собирать доказательства, а не верить словам «готово».

📲 УведомленияПосле завершения агент может прислать Telegram-сообщение.

🔁 ПовторяемостьОдинаковая логика переносится между проектами и чатами.

🧩 Свои модулиПосле урока ты сможешь делать свои Навыки и Автодействия под маркетинг, аналитику, продажи и операционную работу.

Навык проверки готовности превращает приёмку в процесс с доказательствами — Навык — это не справочник терминов, а повторяемый рабочий процесс с понятным критерием готовности.

Человек и ИИ

Тебе не надо становиться программистом

Ты принимаешь решения и проверяешь результат. ИИ-агент делает техническую работу.

Ты	ИИ-агент
Выбираешь среду и цель	Читает существующие настройки и инструкции
Не передаёшь секреты в чат	Делает резервную копию и аккуратно объединяет настройки
Один раз вводишь токен локально	Запускает быструю, техническую и сквозную проверки
Смотришь на реальный результат	Диагностирует ошибки и после исправления повторяет тот же тест

Автодействия автоматически реагируют на события ИИ-агента — Автодействие срабатывает автоматически в нужный момент — это отдельный слой от «памяти» модели.

Маршрут

Весь путь заранее

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

01 · ПОНЯТЬ ОСНОВУРазобраться, чем отличаются инструкция, навык и автодействие.

02 · СКАЧАТЬ НАБОРЗабрать готовые файлы сразу, а не собирать всё с нуля.

03 · ВЫБРАТЬ СРЕДУОпределить, где ты работаешь: ZCode, Claude Code или Codex.

04 · УСТАНОВИТЬИИ сам аккуратно подключит файлы и не затрёт старые настройки.

05 · ВВЕСТИ СЕКРЕТ ЛОКАЛЬНОТокен вводится только у тебя в терминале, а не в чате.

06 · ПРОВЕРИТЬ ОСНОВУУбедиться, что защита и правила действительно работают.

07 · ПРОЙТИ СКВОЗНУЮ ПРОВЕРКУПроверить новый чат, защиту, уведомления и реальный результат.

08 · ПРИНЯТЬ РЕЗУЛЬТАТСчитать работу завершённой только после фактической проверки.

Один нейтральный core и отдельные подключения для ZCode, Claude Code и Codex — Один общий набор, но своё подключение для каждой среды.

Инструкция

Что ИИ-агент должен помнить всегда

В готовом наборе есть короткий файл AGENTS.md. В нём — честность, проверка результата, безопасность, память о проекте и несколько полей о владельце.

Если у тебя уже есть AGENTS.md или CLAUDE.md, установщик его не затирает.

Пример: размытое правило и понятное правило

❌ Слишком размыто

Будь внимательным и всегда всё хорошо проверяй.

✅ Можно выполнить

Не говори «готово», пока не проверен главный пользовательский сценарий. Если проверка невозможна — прямо напиши, что именно не проверено.

Почему второй вариант лучше: ИИ понимает, какое конкретно поведение от него ждут.

Что не надо класть в Инструкцию

Разовую задачу, длинный процесс выпуска, историю текущего чата и тем более токены. Для длинного процесса есть Навык, для событий — Автодействие, для секретов — локальное хранение.

Проверка 1Ты можешь своими словами объяснить, зачем нужна постоянная Инструкция.

Навык

Подробная методичка включается только по нужной задаче

В наборе есть готовый Навык hardcoding-verify-done. Он нужен, когда надо принять работу, проверить выпуск или понять: можно ли честно сказать «готово».

Назвать главный пользовательский сценарий.
Выбрать реальное доказательство результата.
Пройти проверку.
После исправления повторить тот же тест.
Отделить проверенное от непроверенного.

Живой пример: «бот готов?»

Плохая приёмка:

Код компилируется. Готово.

Хорошая приёмка:

Проверено: — бот запущен; — тестовое сообщение отправлено; — Telegram вернул успешный ответ; — пользователь реально получил сообщение.

Доказательство — это не красивый отчёт, а фактическое подтверждение результата.

Проверка 2Среда видит Навык hardcoding-verify-done и понимает, когда его применять.

Безопасная установка: read, backup, merge, verify — Безопасная установка не копирует файлы поверх старых: сначала читает настройки, делает резервную копию, аккуратно объединяет изменения и проверяет результат.

Автодействия

Когда действие должно сработать само

Не запоминай технические названия. Сначала пойми бытовую логику:

Новый чат SessionStartАвтоматически подхватить сохранённое состояние проекта.

Перед действием PreToolUseСначала проверить, безопасно ли то, что собирается сделать ИИ.

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

Завершение StopОтправить короткое уведомление в Telegram.

Пример: защита перед действием

ИИ хочет прочитать .env ↓ Автодействие проверяет файл ↓ Секретный файл → блокировка ↓ Содержимое не попадает в чат

Автодействие — не антивирус и не абсолютная защита компьютера. Оно работает только с теми действиями и событиями, которые выбранная среда передаёт системе.

Проверка 3Быстрая проверка smoke.py убеждается, что тестовый .env блокируется и при чтении файла, и через командную строку.

Среда

Один набор — три среды

Среда	Файл настроек
ZCode	`~/.zcode/cli/config.json`
Claude Code	`~/.claude/settings.json`
Codex	`~/.codex/hooks.json`

Общие служебные файлы лежат в ~/.hardcoding-agent-kit/hooks/. Для каждой среды установщик добавляет только нужное подключение.

Тебе не нужно редактировать JSON руками. Установщик и ИИ-агент делают это сами.

Безопасность

Секретный ключ — только локально

Никаких «пришли токен в чат — я сам запишу». Секретный ключ вводишь только ты и только локально.

Токен Telegram вводится скрытым способом прямо в терминале. ИИ-агенту не нужно знать его значение и не нужно читать файл с секретом.

python3 ~/.hardcoding-agent-kit/configure_telegram.py

Файл создаётся локально: ~/.hardcoding-agent-kit/secrets/telegram.env, права 600.

Секрет остаётся локально и не попадает в чат — Секрет остаётся локально: человек вводит его в терминале, а чат его не видит.

Готовое задание для ИИ

Одна вставка — агент ведёт техническую работу сам

Скопируй задание целиком. Оно закрепляет резервную копию настроек, безопасное подключение, проверки, локальный ввод секретов и правило «готово = результат проверен».

Папка hardcoding-agent-kit-main прикреплена к новому чату coding-агента — **Живой пример из занятия:** kit уже прикреплён к новому чату агента. После этого дай короткую команду: «Установи всё по инструкции, но адаптируй под меня!»

ПРОМПТ ДЛЯ КОПИРОВАНИЯ

Ты мой AI coding agent. Установи Hard Coding Agent Kit безопасно и докажи результат.

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

ИСТОЧНИК:
https://github.com/PavelDumbrao/hardcoding-agent-kit

ПРАВИЛА:
1. Не проси у меня токены, пароли и содержимое .env в обычный чат.
2. Не стирай существующие AGENTS.md / CLAUDE.md / config / hooks.
3. Перед изменением существующего JSON-конфига должен быть backup.
4. Если найдено несколько рантаймов (ZCode / Claude Code / Codex), спроси только какой из них настраиваем.
5. Не говори «готово» без smoke + verify_install. Telegram считается готовым только после реального test_notify.
6. Если предыдущая mutation имеет неизвестный исход — сначала readback, не повторяй её вслепую.

СДЕЛАЙ:

ШАГ 1 · Определи runtime.
- ZCode: ~/.zcode
- Claude Code: ~/.claude
- Codex: ~/.codex
Если найден один — используй его.
Если несколько — задай мне один вопрос: какой главный.

ШАГ 2 · Скачай репозиторий в безопасную временную папку.
Предпочтительно git clone. Если git недоступен — скачай main.zip.
Не исполняй ничего до чтения README.md и install.py.

ШАГ 3 · Проверь installer.
Убедись, что он:
- копирует hooks в ~/.hardcoding-agent-kit/hooks;
- делает backup перед изменением существующего JSON;
- merge-ит hook groups, не затирая другие settings/MCP;
- не перезаписывает существующую постоянную инструкцию;
- ставит ВСЕ Skills из папки skills/ (19 штук) в skill-каталог выбранного рантайма,
  не затирая существующие скиллы с тем же именем (сделай backup, если версия отличается).

ШАГ 4 · Установи:
bash install.sh --runtime <zcode|claude|codex>

Покажи только безопасный итог installer. Не печатай secret-файлы.

ШАГ 5 · Запусти локальный smoke:
python3 ~/.hardcoding-agent-kit/hooks/smoke.py

Норма — все тесты PASS. Если есть FAIL, диагностируй и исправь, затем повтори тот же smoke.

ШАГ 6 · Проверь wiring:
python3 ~/.hardcoding-agent-kit/verify_install.py --runtime <runtime>

Норма — все проверки PASS.

ШАГ 7 · Telegram.
Скажи мне самостоятельно выполнить в терминале:
python3 ~/.hardcoding-agent-kit/configure_telegram.py

ВАЖНО:
- token вводится скрыто в терминале;
- token НИКОГДА не отправлять тебе в чат;
- после моего сообщения «ввёл» запусти:
  python3 ~/.hardcoding-agent-kit/hooks/test_notify.py
- Telegram считается проверенным только если команда PASS и я реально получил сообщение.

ШАГ 8 · Мини-проверка Skill.
Попроси runtime показать/найти Skill `hardcoding-verify-done`.
Затем дай ему тестовую задачу: «Проверь, можно ли честно сказать готово».
Убедись, что он требует evidence, а не просто повторяет статус.
Затем попроси показать реестр скиллов и убедись, что установленные из набора
(expert-landing-express, cc-design, telegram-mini-apps и другие) видны.

ШАГ 9 · Адаптируй под меня (фраза ученика: «адаптируй под меня»).
Задай мне 4 коротких вопроса: чем я занимаюсь, какие типовые задачи,
какие проекты делаю, какой стиль общения предпочитаю.
Запиши ответы в раздел «Мои данные» установленной инструкции
(AGENTS.md / CLAUDE.md — по рантайму) и покажи мне итог.
Затем порекомендуй 2-3 скилла из установленных, полезнее всего под мои задачи,
и как их вызывать (просто попроси агента по названию).

ФИНАЛЬНЫЙ ОТЧЁТ:
- runtime;
- config path;
- backup path, если был;
- hooks path;
- skill path;
- smoke: X/X;
- verify_install: X/X;
- Telegram E2E: PASS / не настраивали;
- что осталось человеку руками.

Не заявляй completion, пока обязательные локальные проверки не пройдены.

Проверка 4После установки выбранная среда подключена, а прежние настройки и другие подключения не потеряны.

Установка и проверка

Пять маленьких шагов вместо одной большой магии

Здесь важно не просто выполнить команды, а понимать, что каждая из них доказывает.

1 · Установить готовый набор

bash install.sh --runtime zcode

Здесь zcode — техническое имя выбранной среды. Для Claude Code используй claude, для Codex — codex.

2 · Быстрая проверка — работает ли логика самого набора

python3 ~/.hardcoding-agent-kit/hooks/smoke.py

Эта команда проверяет базовую защиту: опасный сценарий блокируется, безопасный разрешается. Но она ещё не доказывает, что выбранная среда действительно подключила автодействия.

3 · Проверка подключения — видит ли среда наш набор

python3 ~/.hardcoding-agent-kit/verify_install.py --runtime zcode

Эта команда отвечает на простой вопрос: «моя среда действительно подключила новые правила и автодействия?»

4 · Настроить уведомления Telegram

python3 ~/.hardcoding-agent-kit/configure_telegram.py python3 ~/.hardcoding-agent-kit/hooks/test_notify.py

5 · Сквозная проверка — смотрим на результат глазами пользователя

Память о проекте: открой новый чат в проекте с сохранённым состоянием и спроси: «На каком этапе проект и какой следующий шаг?»

Защита: создай только тестовый файл .env с безопасной строкой:

DEMO_SECRET=not-a-real-secret

Попроси ИИ прочитать этот тестовый .env обычным инструментом чтения. Ожидаемый результат: чтение блокируется до того, как секрет попадёт в чат.

Telegram: проверка считается успешной только если сообщение реально пришло тебе, а не потому что терминал написал «успешно».

Навык: спроси «Можно ли честно сказать, что установка готова?» — хороший ИИ-агент сначала соберёт доказательства, а уже потом ответит.

Лестница доказательств: быстрая проверка, подключение, сквозная проверка и результат — Лестница доказательств: быстрая проверка → проверка подключения → сквозная проверка → пользователь видит результат.

Если агент застрял

Короткое задание возвращает ИИ к работе

ЗАДАНИЕ ДЛЯ ПРОДОЛЖЕНИЯ

Ты технический исполнитель. Не перекладывай техническую работу на меня.

Продолжай с текущего состояния, не начинай заново.
Сначала прочитай реальные настройки и существующие инструкции.
Перед изменением существующего JSON-файла сделай резервную копию.
Исправляй только то, что мешает текущему шагу.
После исправления повтори тот же тест.
Если действие пользователя неизбежно — дай мне только ОДНО конкретное действие.
Токены, пароли и содержимое .env в чат не проси.
Не говори «готово» без реальной проверки результата.

Доказательства

Лестница: от «кажется работает» до реального результата

Быстрая проверка — проверили логику самого набора.

Подключение — доказали, что набор подключён к выбранной среде.

Сквозная проверка — прошли настоящий сценарий от начала до конца.

Результат пользователя — человек реально получил ожидаемый итог.

Почему это важно

«Файл существует» не доказывает, что Автодействие запускается. «Автодействие запускается» не доказывает, что Telegram-сообщение дошло. Чем ближе проверка к пользователю — тем сильнее доказательство.

Развивай систему

Куда относить свои будущие идеи

Задай себе один вопрос: это правило должно действовать всегда, нужен отдельный процесс или действие должно сработать само?

«Всегда пиши, что проверено»Инструкция

«Проведи выпуск по чек-листу»Навык

«Перед изменением базы данных проверь резервную копию»Автодействие

«После долгой задачи пришли уведомление»Автодействие

«Собери мини-приложение Telegram от идеи до полной проверки»Навык

«Никогда не выдумывай результаты тестов»Инструкция

Финал

Теперь у тебя не «умный чат». У тебя управляемый ИИ-агент.

Инструкция задаёт постоянные правила. Навык подключает глубокий процесс. Автодействие реагирует на событие. А реальные доказательства не дают системе выдавать желаемое за готовый результат.

Следующий уровень — делать свои Навыки и Автодействия под повторяющиеся процессы бизнеса.

Скачать готовый набор ↓Проверить по списку

Обучи своего ИИ-агента