Урок 8 из 8
Вайб-кодинг с LangGraph: как ставить задачи Claude Code
Цель урока: собрать всё выученное в главный практический навык - грамотно заказывать LangGraph-приложения у ИИ и грамотно принимать работу. Код пишет Claude, архитектуру заказываешь ты.
Формула хорошего ТЗ
Всё, что ты выучил в уроках 1-7, - это и есть язык постановки задачи. Хорошее ТЗ на LangGraph-приложение отвечает на пять вопросов:
- Процесс: какие шаги, в каком порядке? (узлы и рёбра, урок 4)
- Развилки: где процесс ветвится и по каким условиям? Где циклы доработки? (урок 4)
- Данные: что должны знать все шаги? Какие поля копятся, какие перезаписываются? (состояние, урок 3)
- Паузы: перед какими действиями процесс обязан остановиться и спросить человека? (interrupt, урок 5)
- Память: что помнить внутри разговора, а что - о пользователе навсегда? (чекпоинтер и Store, урок 5)
«Сделай LangGraph-приложение для обработки заявок школы. Процесс: классификация → подготовка ответа → проверка качества → отправка. Развилки: после классификации сложные вопросы уходят куратору; после проверки слабый ответ возвращается на доработку, максимум 2 круга. Состояние: текст заявки, категория, история сообщений (копилка), черновик, вердикт проверки. Паузы: перед отправкой ответа новому клиенту - interrupt на моё подтверждение. Память: чекпоинты в PostgreSQL, тред = один клиент. Покажи mermaid-схему графа до того, как писать код».
Волшебные фразы
Формулировки, которые сразу направляют Claude Code к правильной архитектуре (полный набор - в справочнике промптов):
| Скажи | Получишь |
|---|---|
| «Покажи mermaid-схему графа до кода» | Схему для проверки архитектуры - до того, как потрачено время на код |
| «Чекпоинты в PostgreSQL, тред = один клиент» | Настоящую устойчивость вместо памяти-однодневки |
| «Перед [действием] - interrupt на моё подтверждение» | Человека в контуре на опасных действиях |
| «В цикле доработки - максимум N попыток» | Предохранитель от вечного цикла и сожжённых токенов |
| «Начни с одного агента, без мультиагентности» | Простую архитектуру, которую можно усложнить потом |
| «Подключи стриминг: показывай пользователю текущий шаг» | Живой прогресс вместо зависшего экрана |
Как принимать работу
Код ты не читаешь вовсе - ты проверяешь архитектуру и поведение:
- Сверь схему. Попроси mermaid-схему готового графа и сравни со своей: все ли развилки, циклы и паузы на месте?
- Прогони сценарии. Типовой запрос, сложный запрос, злой клиент, бессмыслица на входе. Смотри, по тем ли веткам пошёл процесс.
- Устрой сбой. Останови приложение посреди процесса и запусти снова: продолжил ли с места остановки? Это проверка чекпоинтов.
- Проверь паузу. Дошёл ли процесс до interrupt и правда ли ждёт твоего решения, а не шлёт письмо сам?
- Спроси про тесты. «Какие тесты покрывают узлы и развилки? Запусти их и покажи результат».
- Заказывать технологию, а не процесс. «Сделай мультиагентную систему на LangGraph» - плохо. «Вот процесс с шагами и развилками» - хорошо: технологию пусть предлагает Claude.
- Не описать развилки. ИИ построит счастливый путь без обработки сложных случаев - а жизнь состоит из сложных случаев.
- Забыть про паузы. Агент без interrupt сам отправит клиенту письмо со скидкой 90%. Опасные действия - только через согласование.
- Принимать по коду, а не по поведению. Красивый код может делать не то. Сценарии и схема - твой инструмент приёмки.
Куда расти дальше
- Построй с Claude Code первый настоящий граф под свою задачу - лучший следующий шаг после этого курса.
- Держи под рукой шпаргалку решений и глоссарий.
- За «мудростью» - в сообщества: форум LangChain и r/LangChain. И расскажи о LangGraph в своём клубе: объяснить другим - лучший тест понимания.
Проверь себя
1. Какая постановка задачи для Claude Code лучше?
2. Как проверить, что чекпоинты реально работают?
3. Claude построил граф. По какому главному признаку ты принимаешь работу?
Выбери одну свою реальную задачу и составь для неё ТЗ по формуле из этого урока (пять вопросов). Отдай его Claude Code и попроси сначала схему. Это и будет выпускной экзамен курса - настоящий, боевой.