Методичка на A4: как объяснить ИИ-инструмент человеку за одну страницу

Я держу распечатанный лист рядом с монитором. На нём вся инструкция по работе с Claude Code — один A4, обычный шрифт, без скриншотов. Остальное лежит в репозитории и открывается только когда что-то сломалось.

Формат родился из наблюдения: люди пропускают документацию на двенадцать экранов. Читают первые три строки и идут спрашивать в чат. Лист бумаги читают целиком, потому что он заканчивается.

Ограничение объёма делает работу за вас

Одна страница — это примерно 350–400 слов, если не мельчить шрифт. В такой объём не помещается ни описание архитектуры, ни список возможностей, ни философия подхода. Помещается только то, что человек делает руками каждый день.

Когда я урезал свою инструкцию до листа, выяснилось: большая часть текста описывала ситуации, которые случаются раз в месяц. Они переехали в отдельный файл. На листе остался ежедневный минимум.

Пять блоков, которые должны быть на странице

Ритуал запуска. Три пункта, по одному действию в каждом. У меня это: открой Claude Code → он сам покажет задачи в работе → скажи, что хочешь делать. Ключевая строка — «не надо ничего копировать». Она снимает главный страх новичка, что придётся куда-то лезть и переносить данные руками.

Развилки. Человек садится за инструмент в одном из четырёх состояний: задача одна, задач несколько, задача новая, надо посмотреть очередь. Для каждого состояния — готовая фраза. Одна задача → «продолжи». Несколько → «продолжи [название]». Новая работа → просто опиши словами, задача заведётся сама. Посмотреть очередь → «что в бэклоге?».

Ремонт самого процесса. Инструмент настроен неудобно — что говорить? У меня одна строка: «давай поправим воркфлоу». Без этого блока люди терпят кривую настройку месяцами и считают, что так и задумано.

Ремонт поведения ИИ. Модель повторяет одну и ту же ошибку — как её отучить? «Запиши это в rules». Правило попадает в конфиг, ошибка исчезает. Этот пункт превращает пользователя из жертвы в человека, который правит систему.

Одна ссылка. Куда идти за подробностями. Ровно одна, иначе страница превращается в каталог.

Пишите готовые фразы

Главная ошибка методичек — описывать возможности. «Инструмент поддерживает работу с задачами через интеграцию с трекером» — бесполезная строка. Человеку нужен текст, который он скопирует губами и произнесёт вслух.

Проверка простая: каждая строка либо действие («открой»), либо реплика в кавычках («продолжи»). Всё остальное — украшение, которое съедает место.

Тест на живом человеке

Распечатайте лист, посадите рядом коллегу, который инструмент не видел. Молчите. Смотрите, где он споткнётся.

У меня на этом тесте вылетели два пункта: описание структуры проекта и раздел про горячие клавиши. В них никто не заглянул. Зато добавился блок про повторяющиеся ошибки — человек трижды получил один и тот же неверный ответ и не знал, что с этим делать.

Молчание — обязательная часть теста. Как только начинаете подсказывать, вы тестируете себя.

Что остаётся за пределами листа

Всё редкое и всё длинное: правила работы с ветками, шаблоны задач, настройка окружения, разбор частых ошибок. Это живёт рядом с кодом — у меня в файлах rules внутри репозитория. Их читает модель. Человек туда заглядывает раз в месяц.

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

Лист живёт и меняется

Моя методичка переписывалась несколько раз. Каждый раз повод один — кто-то задал вопрос, ответ на который должен был быть на листе.

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

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