ЛютикПодробная история кейса: с чего начинали, что сделали, что экономится
Кратко. «Память системы» — часть Штаба, собственной системы AI-студии Лютик. Внутри проекта живёт робот документации: он хранит решения с причинами, «грабли» — починенные поломки со сторожем — и неочевидные связи. Когда ИИ-агент или разработчик открывает файл, робот сам показывает, что о нём известно, а правку без документа не пропускает. Хронику по дням и карту кода он собирает сам, по понедельникам присылает отчёт в MAX. Такую память мы ставим в каждый крупный проект, который делаем для клиентов.
Паспорт. Часть системы «Штаб». Робот включён 13 октября 2026, в Штабе и двух соседних системах. Записано 60 решений, 82 граблей, 21 неочевидная связь, 13 процессов и 11 потоков данных; 144 привязок «код → документ», 5 870 строк документов.
С чего начинали
Штаб пишут люди и ИИ-агенты, и каждый новый участник начинает с нуля: почему так сделано, знал только тот, кто делал.
Что было
Одну и ту же поломку чинили дважды, правильное решение «исправляли» обратно, а описания устаревали молча.
Что сделали: 7 задач
1. ИИ-агент видит историю файла до правки
Как было. Новый разработчик или ИИ-агент открывал файл и не знал, что его уже чинили, почему он устроен именно так и что сломается рядом. Сделали. Робот документации встроен в работу агента: как только тот открывает файл, робот показывает решения, «грабли» и связи по этому файлу, кто от него зависит и какой документ поправить. В начале работы — сводку: что под подозрением, какие поломки ещё без сторожа. Что дало. Любой новый разработчик или ИИ-агент меняет код без страха сломать то, что уже чинили.
2. Каждое решение записано с причиной
Как было. Почему сделано именно так, помнили только те, кто делал. Через месяц правильное решение «исправляли» обратно. Сделали. 60 записанных решений: что решили, почему и что сознательно не делаем, плюс пути кода, где решение действует. Отменённое не стирается — помечается и заменяется новой записью. Отдельно — таблица из 26 пунктов «чего не делаем и почему». Что дало. Спор «а почему так?» решается одной ссылкой, а не созвоном.
3. Починенное не ломается второй раз
Как было. Поломку чинили, а через месяц она возвращалась с другой правкой — и её искали заново. Сделали. Каждая починенная поломка — «грабля»: симптом, причина, починка и сторож — проверка, которая не даст ей вернуться. Записано 82 граблей. Коммит с починкой несёт метку грабли, и робот замечает, если та же грабля чинится повторно. Что дало. Одну и ту же поломку не оплачивают дважды.
4. Видно, что сломается, если тронуть
Как было. Неочевидные связи — оплата двигает карту, имя человека держит его долю в соседней системе — знал один разработчик. Сделали. 21 записанная связь «трогаешь → сломается → проверить», обычные связи робот считает сам. Он смотрит и в соседние системы — Охоту и Кочевой реестр — и предупреждает, где проверить там. Что дало. Правка в одной системе не роняет соседние.
5. Документы не устаревают молча
Как было. Описания писали один раз, потом код уходил вперёд, а документ врал. Сделали. У каждого файла кода есть закреплённый документ (144 привязок). Поменял код и не тронул документ — робот не принимает правку, пока документ не поправлен или не написано, почему он не нужен. Документ, код которого менялся после сверки, помечается «под подозрением». Что дало. С включения робота 76 % правок сами говорят, какой документ поправлен или почему он не нужен.
6. История проекта по дням собирается сама
Как было. Что и когда менялось, восстанавливали по памяти и переписке. Сделали. Робот собирает хронику по дням из истории правок: каждая правка — с номерами решений, граблей и документов, которые она задела. Тем же способом он собирает карту кода: модуль, назначение, документы, кто зависит. Что дало. История проекта есть всегда, и её никто не пишет руками.
7. Раз в неделю — отчёт руководителю в MAX
Как было. Чтобы понять, следит ли команда за документами, нужно было спрашивать. Сделали. По понедельникам робот присылает в MAX короткий отчёт по Штабу и соседним системам: сколько правок пришли с документом, что починили и не повторилось ли, какие поломки ещё без сторожа, что под подозрением. Что дало. Порядок в документах виден руководителю без единого вопроса.
Что экономит и приносит деньги
- 24 часов разработчика на повторах. Каждая из 82 починенных поломок записана со сторожем — проверкой, которая не даёт ей вернуться. Оценка: если без сторожей вернулась бы хотя бы каждая 10-я — это 8 поломок × 3 часа на поиск причины = 24 часа.
- Проект не привязан к одному человеку. 60 решений с причинами и 21 неочевидная связь записаны рядом с кодом — их не нужно держать в голове. Оценка: новый разработчик или ИИ-агент вникает в модуль за 2 часа вместо 16 — в 8 раз быстрее.
Что экономит время
- Почему сделано так. Решение с причиной и тем, что сознательно не сделано, открывается по номеру или всплывает само. Оценка: искать в переписке и истории правок — около 30 минут → около 1 минуты, в 30 раз быстрее.
- История проекта. Хронику по дням и карту кода робот собирает из истории правок. Оценка: собрать руками, что менялось за неделю, — около часа → ноль, робот делает это сам.
- Недельный отчёт. По понедельникам в MAX: что правили, что починили, где документы отстали от кода — по Штабу и соседям. Оценка: около 60 минут руководителя в неделю → прочитать одно сообщение.
Где проходит наша граница
Мы отвечаем за то, что робот показывает только записанное и проверяет правку до того, как она попадёт в проект. Что записать и как решить, решают люди. На кадрах — вымышленные решения и поломки в том же формате, без настоящих имён и денег.
Частые вопросы
Что такое «грабля»?
Починенная поломка, записанная с симптомом, причиной, починкой и сторожем — проверкой, которая не даст ей вернуться.
Как робот помогает ИИ-агенту?
Когда агент открывает файл, робот сразу показывает решения, грабли и связи по этому файлу и какой документ нужно поправить вместе с кодом.
Что будет, если поменять код и забыть про документ?
Робот не примет правку, пока документ не поправлен или в сообщении не написано, почему он не нужен.
Можно ли поставить такого робота в другой проект?
Да, и мы так и делаем: это наше открытие, его мы ставим в каждый крупный проект для клиентов. Память нужна везде, где код правят несколько людей или ИИ-агенты. Да: это один файл и одна настройка, без внешних библиотек; он уже работает в трёх наших системах.