Правило было записано. За 239 сессий оно сработало один раз

Почему правило не работало

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

Я проверил, как это исполняется. Не по ощущению, а по журналам: за 239 рабочих сессий роутер вызвался один раз. Детектор дефектов и скилл премиальной вёрстки не вызывались ни разу.

Причина не в лени и не в качестве инструментов. Инструмент подхватывается по описанию, вероятностно. Когда он не подхватился, страница всё равно выходит и выглядит ровно так же, как если бы он отработал. Провал неотличим от успеха изнутри.

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

Что вы собираете

Прежде чем разбирать конвейер, стоит договориться о предмете. Дальше речь про страницы: лендинг из нескольких экранов или сайт из нескольких страниц. Всё, что живёт на сервере, конвейер не трогает, и об этом сказано в конце раздела.

Четыре слоя любой страницы

Собираются строго в этом порядке, и порядок объясняет, почему фазы идут именно так.

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

Лендинг и сайт: что меняется в работе

Бриф, направление и блюпринт делаются один раз на весь сайт. Прототип, тексты, вёрстка и приёмка проходятся по каждой странице отдельно.

Чего конвейер не делает

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

Граница простая: если для страницы достаточно файлов, конвейер её соберёт. Если нужен сервер, который что-то помнит между визитами, это уже приложение, а не сайт.

Что нужно до старта

Claude Code, Node двадцатой версии или новее, git. Ниже сказано, что скачать и, главное, куда всё это вводить.

Куда вводить команды

Мест ровно два, и они разные. Половина непонимания в таких инструкциях именно отсюда.

Переключаться туда-сюда не обязательно. Любую команду терминала можно выполнить прямо в Claude Code: наберите её через восклицательный знак, например !node --version. Или просто попросите словами, и он выполнит сам.

Открыть Claude Code и выбрать модель

Запустите приложение Claude и переключитесь на вкладку Code вверху слева. Внизу, рядом с полем ввода, выберите папку, в которой будете работать, и модель. Ставьте Opus 5 и режим High: разбираться в чужом окружении и чинить установку это как раз та работа, где слабая модель сдаётся, а сильная доводит до конца.

Проверить окружение одним промптом

Дальше ничего проверять руками не нужно. Вставьте этот текст в поле ввода Claude Code, и он сам посмотрит, что стоит, доставит недостающее и отчитается таблицей.

Проверь, что установлено на этом компьютере: Git, Node.js, npm и PowerShell 7.
Выполни в терминале проверку версий по очереди: git --version, node --version,
npm --version, pwsh --version. Выведи аккуратную таблицу: программа | установлено
(да/нет) | версия. Чего не хватает, установи через winget: Git.Git,
OpenJS.NodeJS.LTS, Microsoft.PowerShell. После установки проверь версии повторно
и в конце скажи одной строкой, всё ли готово к работе. Отдельной строкой напомни
мне закрыть приложение Claude полностью и открыть заново. До перезапуска только
что установленные программы могут не подхватиться.

На macOS тот же промпт работает, только вместо winget Claude Code возьмёт brew. Node нужен двадцатой версии или новее, и он об этом скажет сам.

Промпт попросит разрешение на каждую установку: это нормально, соглашайтесь. После перезапуска приложения вернитесь на вкладку Code и в ту же папку.

Как разговаривать с Claude Code

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

Говорите целями, а не инструкциями. «Собери страницу про корпоративное обучение, целевое действие одно: заявка на диагностику» работает лучше, чем «создай файл index.html и добавь секцию hero». Во втором случае вы делаете его работу и теряете всё, ради чего он нужен.

Он спрашивает разрешение. Перед тем как поменять что-то на диске или выполнить команду, он показывает, что именно собирается сделать. Читайте эти окошки первое время: из них быстро становится понятно, как он думает.

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

Если ответы стали поверхностными, посмотрите на модель в правом нижнем углу. На Opus 5 в режиме High он думает дольше и доводит до конца, на быстрых моделях чаще сдаётся на середине.

Поставить механику

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

Как поставить

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

Поставь мне комплект «оркестр сайта»: git clone https://github.com/ikigai-promotion-kz/ikigai-site-orchestra-kit site-orchestra-kit
Прочитай в нём УСТАНОВКА.md и выполни установку по ней.
Ничего моего не перезаписывай: файл, который уже есть, оставь и покажи, что в нём поменять.
Объясняй каждый шаг простыми словами, ключи и пароли у меня не спрашивай.
В конце прогони самодиагностику и переведи её вывод: что обязательно, что желательно
и что я теряю по каждому жёлтому пункту. Не пиши «всё ок», если есть жёлтые.

Дальше — два шага, которые стоит сделать в этом порядке: собрать свой канон командой /canon и прогнать учебную страницу demo/slomannaya. Она сломана нарочно, и приёмка обязана найти четыре поломки из четырёх. Нашла меньше, значит чинить надо приёмку, а не страницу.

Комплект готов. Все четыре части лежат в одном репозитории и ставятся туда же, куда скиллы: ikigai-site-orchestra-kit. Механика больше не знает наших путей — она спрашивает их у файла настройки в корне вашего проекта.

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

• пути к вашим страницам и к папке прогонов — один файл orchestra.config.json;
• канон — команда /canon задаёт вопросы про бренд, шрифты и фон, а файл пишет скрипт;
• шаг голоса бренда — поле в настройке: впишите имя своего скилла или оставьте пустым, и шаг пропустится.

Собрать первую страницу

Слева то, что вы говорите Claude Code, справа то, что появляется на диске. Пока файл не появился, фаза не закрыта.

С чего начать

Комплект стоит, инструменты на месте. Дальше нужна папка, в которой будет жить ваш сайт, и открытый в ней Claude Code. Без этого первая команда выполнится неизвестно где, и результат придётся искать по всему диску.

Папку тоже создаёт Claude Code. Скажите ему прямо:

Создай в текущей папке подпапку moy-sait под новый сайт и перейди в неё.
Покажи полный путь, чтобы я понимал, где мы работаем.

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

Про слаг. moy-sait в командах ниже это имя вашей страницы латиницей. Оно станет именем папки, попадёт в адрес и будет повторяться в каждой команде прогона. Выбирайте один раз и не переименовывайте потом: на имя завязаны пути.

Claude Code назовёт полный путь, когда создаст папку. Если потеряетесь, спросите словами: «где лежат файлы страницы, а где артефакты прогона». Он ответит путями, а не описанием.

Запустить прогон

Одна команда. Наберите её в Claude Code, и дальше он ведёт вас сам: задаёт вопросы, зовёт нужные инструменты, кладёт файлы по фазам.

/site moy-sait

Прогон он откроет сам: это первый шаг партитуры, а не ваша забота. Служебные команды вида node tools/orchestra.mjs … вы дальше увидите в его работе, но набирать их не нужно. Они выполняются за вас, и мы показываем их в таблицах ниже только затем, чтобы было видно, что именно происходит и какой файл появляется.

Подготовка

После третьей строки дверь открывается: до этого момента запись в файлы страницы блокируется.

Сборка

Порядок в текстах нарушать нельзя. Голос идёт до вычистки: запустите вычистку раньше, и она сотрёт живые обороты как машинные следы, а всё, что делало текст вашим, нормализуется прочь.

Приёмка

Про машинную приёмку. Скрипт написан и входит в комплект. Он меряет четыре вещи: переполнение на пяти ширинах обходом элементов, а не через scrollWidth: тот при overflow-x:hidden равен ширине экрана и всегда говорит «всё хорошо»; контраст по WCAG с поиском фактического фона подъёмом по предкам; канон по папке целиком; битые якоря. Непроверенное он пройденным не считает: нет браузера — пишет отказ и называет причину, а не зелёный отчёт без единого замера.

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

Покажи перекличку: кто вступил, кто промолчал.

Как править готовый сайт

Страница собрана и лежит на своём домене. Дальше начинается обычная жизнь: поправить цифру, переписать секцию, добавить блок. Развилка одна, и запомнить надо только её: насколько велика правка.

Мелкая правка. Скажите в Claude Code своими словами:

Мелкая правка на moy-sait: поправь цену в тарифах на 149 000.
Открой режим правки и запиши причину.

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

Большая правка. Там же:

/site moy-sait

Посмотреть до публикации

Откройте файл страницы в браузере двойным кликом. Этого хватает, пока адреса выглядят как index.html.

Если в ссылках стоят пути без расширения, вида /business, простого открытия файла мало: браузер такой путь не найдёт. Поднимите в папке сайта любой статический сервер и откройте адрес, который он напечатает. Мы на этом обожглись: локально ссылка давала ошибку при полностью рабочем сайте на домене.

Опубликовать

Публикация к механике отношения не имеет, и наш способ не единственный. Принцип общий: папка сайта уезжает на хостинг, который отдаёт статику.

Мы держим страницы на Vercel и публикуем отправкой в git: изменения в папке проекта уезжают сами. Подойдёт любой хостинг статики, вплоть до GitHub Pages.

Чтобы страница открывалась по ссылке, нужны две вещи, и покупаются они в разных местах: место, где лежат файлы, и имя, по которому это место находят. Пока нет ни того ни другого, сайт существует только на вашем компьютере.

Начинать со своего сервера смысла нет: он дороже и дольше, и за ним нужен человек, который будет следить. Статическую страницу такой сервер отдаёт ровно так же, как Vercel, — разница только в том, сколько времени вы потратите до первого рабочего адреса.

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

Помоги опубликовать сайт moy-sait: заведи проект на хостинге, подключи папку и доведи до рабочего адреса.
Домен я купил у регистратора. Скажи, какие записи и где прописать, и проверь, что сертификат выпустился.
Объясняй простыми словами и по шагам, ключи и пароли у меня не спрашивай.

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

Что видит владелец

В конце сессии печатается перекличка: по фазам, с именами тех, кто не вступил. Попросить её можно словами:

Покажи перекличку по текущему прогону.

То же самое командой, если хотите точности: node tools/orchestra-check.mjs

Так выглядит её вывод:

Фаза 1  Направление
      web-design-router          ✅ вызван 1×
      ui-ux-pro-max              ✅ вызван 1×
      design-taste-frontend      ✅ вызван 1×
      high-end-visual-design     ❌ НЕ ВЫЗЫВАЛСЯ

ИТОГ: отыграно фаз 4 из 8.
Гейт: живой. Обходов: 0.

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

Отдельный сигнал: доказательствам нельзя верить. Он загорается, когда защита не отработала, журнал детектора пуст или гейт обошли после серии отказов. Это не то же самое, что «нарушений нет». Разница между «мы проверили и чисто» и «проверять было нечем» стоит того, чтобы её видеть.

Честные границы

Этот раздел идёт до предложения о работе, а не после.

Это защита от забывчивости, а не от намерения. Мы считаем, что так честнее, чем обещать невозможное.

Серия гайдов

Три материала одного жанра: как у нас устроено производство, с замерами и границами.