Бустер для мозга. Projects в Claude. Методологическая магия

Спойлер

Может показаться что я рекламирую Claude - нет, у ChatGPT есть такая же штука.

Захочется наброситься со словами - да это же очевидно, открыл Америку! - жгите слогом.

Нейроскептики скажут - опять доверили стохастическому генератору ответственное дело, куда катится мир! - ОПС, ребята

Тут как в FPV - если есть 10 лет опыта, то технологии настолько быстро меняются, что последний год всегда перечеркивает весь предыдущий опыт.

О предметной области

У меня есть продуктовая компания, которая производит и продает контроллеры, позволяющие управлять освещением. Это тысячи электронных плат в год.

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

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

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

Почему задача буксует

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

• Программисты микроконтроллеров, чтобы вшить в железо какие-то активности

• Программисты Цифровой платформы - разработать интерфейсы и таблицы

• Конструктора, проектирующие и собирающие

• Дизайнеры, рисующие юзабильный GUI

• Инженеры, сначала офигивающие, потом курирующие процессы.

• Пусконаладчики со своими тараканами, стенд использующие

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

Первый шаг - прогрызть задачу. Что значит:

1. Разместить в мозгу все что есть

2. Наметить то что будет, прикинуть как оно может быть

3. Широкими мазками прикинуть как размазать задачу между командами

4. Позадавать разным людям вопросов, которые без полного контекста кажутся бредом

5. Оценить риски

6. Все упростить и уже этот понимаемый вариант отправить в обсуждение.

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

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

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

Можно по старинке - написать ТЗ, которое никто не будет читать… дальше даже думать не хочется.

Двумя словами: задача не помещается в мозг, а разделить ее на старте с кем-то не выходит - все сразу тонут в детали.

Claide.ai

Я попробовал разные, считай, все что в моде. Но остановился на Клоде. Для технических задач - очень хорош. Но интерфейс в виде диалога помогает в текущих задачах, а когда надо подумать в масштабе - только делает хуже.

Как только Клод схватил уроборос - начинай новый диалог без старого контекста и вводных. Присматривался к ClaudeCode с его Claude.md. Пишут, что энтузиасты научились использовать этот оркестр агентов не только для программирования. Пока не могу придумать как собрать на ClaudeCode среду для прогрызания сложных вещей абстрактных от кода.

Осталась мысль, что в веб интерфейсе Клода должно же быть что-то похожее.

Проекты в Claude

В стандартном интерфейсе Клода все понятно, кроме вкладки Projects. Если честно, я вообще ингорил все кроме Chats. А тут решил глянуть что такое Проекты (рисунок 1).

На просторах Youtube сразу наткнулся на маркетологов, которые используют проекты Клода. Маркетологи - отдельная каста людей, которые умеют творить чушь, чтобы продать чушь, которая нафик никому не нужна. Но у них получается и те, что в топе Youtube, в целом, прикольные. Посмотрел русских, тарабарских (рисунок 2)… и прозрел!

Конфиг Проекта

Дальше будет моя интерпретация, вероятно, авторы Клода не во всем с ней согласятся. В проекте есть 4 сущности (рисунок 3):

1. Instruction - базовый системный промпт, который подставляется во все диалоги с LLM. Это удобно так как не надо откуда-то копировать этот промпт для начала нового диалоге взамен протухшего. Плюс, разрабы Клода, скорее всего, подошли умно и кэшируют этот системный промпт уже в виде токенов. А может еще глубже.

2. Files - сюда маркетологи подкладывают фирменные стили, примеры нейрослопа. Думаю это тоже эффективно кэшируется. Этому надо еще найти применение.

3. Memory - Summary - конструкция, которая собирается по ходу проекта. Но ее можно чуть подправить, чтобы вильнуть стохастический инференс в нужную сторону.

4. И сам классический чат, который может довести отдельных людей до самоубийства.

На самом деле, есть еще 5 элемент, доступный на десктопной версии - MCP. Но это уже отдельная история.

Методологическое

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

Технологии - очень круто, но в основе любого чуда лежит работа, много работы.

Возвращаемся к Стенду ОТК и аксиоме “без ТЗ жди ХЗ”. Два дня ушло на написание ТЗ. Но в этот раз ТЗ было написано не по классике ГОСТ 34.602-89, а для ИИ (рисунок 4).

В принципе, из ТЗ, как из из песни, разделов не выкинешь. Сначала была суть, потом появились ТЗ, потом появился ГОСТ, но суть осталась. Нюанс в том, что ТЗ адаптировано под ИИ, и вполне понятно человеку. А еще, если Клод (и не только Клод) где-от виляет - это ТЗ можно дописать. Получился живой динамичный документ.

Как адаптировать ТЗ по ИИ - пока четких правил нет. Исключительно по наитию:

1. Разметка MD. Структура заголовков, маркеры ** для усиления. Слова ВАЖНО, ОШИБКА

2. Примеры. Много примеров. Примеры для инференса - все.

3. Вопрос Клоду - дай оценку ТЗ. Он, конечно, накидал, но некоторые моменты были очень в тему - доработал.

4. Правка ТЗ. Как только вероятности токенов убегают в сторону от генеральной линии - правим ТЗ. А улетают они не только по тому, что ИИ нельзя доверить важное дело, а еще потому что кто-то не додумал исходные данные или детали задачи.

Пример чуда

Когда собрал новый коптер - первый взлет всегда предвкушение. Обычно либо пожар, либо поломка, но, бывает, летит. Пробуем собранную конструкцию из ТЗ и Проектов Клода (рисунок 5).

Процесс согласования:

1. Клод сгенерировал Артефакт с интерфейсом.

2. Скрин результата в чат производства. Пуско-наладчики начали долбить вопросами как будет работать. Приходте - покажу. Артефакт, кстати, получился рабочий с драг&дроп и все такое.

3. 15 минут с артефактом и пусконаладчиками - появились поля для ввода номера, очистка слотов.

30 минут - на выходе согласованный визуально и ФУНКЦИОНАЛЬНО интерфейс с нюансами (риснок 6). В прошлой жизни все это заняло бы две-три недели боли. А тут бонусом готовая нарезка со скриптами.

Это ли не настоящее чудо, творимое технологиями?!

Инсайты

Ускорение

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

Применение Files

Нашлось применение Files (рисунок 7). Туда отлично легла документация по нашему API, пример JSON с кучей вариантов. LLM очень любят примеры. Они состоят из примеров. И чтобы не забивать системный промпт - удобно хранить примеры файлами.

Изменение подхода

Все эти МНОГО БУКВ лишь про одно: появилась технологическая возможность изменить подход к сложным процессам:

• Раньше мы выгружали ТЗ в статичную структуру документа исключительно для синхронизации между участниками процесса. ТЗ всегда написаны коряво, читают его через строчку - синхронизация всегда скользит и спотыкается.

• Теперь ТЗ стало проактивным участником процесса. Сложно осознать к чему это приведет. Ускорение - один из бонусов.

Основная сложность — научить команду работать с живыми ТЗ вместо статичных документов.

Бонус!

Коллеги, если Вас бесит что Клод отправляет недосказанное сообщение при нажатии Enter, хотели добавить нюанс, но теперь он варит кашу без него - пользуйтесь плагином Fix Claude's Enter Key

Заключение

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

Подход простой:

- Структурированное ТЗ в Markdown

- Примеры в Files

- Живой диалог вместо статичного документа.

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