minders.astanaИИ-комьюнити Астаны · 6 сентября 2026
ИИ на пути к документации, которая всегда актуальна
Мы предлагаем автодокументацию на базе Кольца Автотестов.
Жанр — быль.
Сергей Буш — организационно-технологический советник
Хардсофт321 · Lab321 GmbH, Берлин
bush10.org/blog/ring-of-autotests/
Вопрос
Можно ли получить документацию, которая всегда актуальна?
Да.
И было можно задолго до ИИ.
Попросим модель
«Сделай пользовательскую документацию для этой программы и поддерживай её в актуальном состоянии».
Напишет. Быстро и гладко.
Желание исполнено дословно: текст пишется заново на каждый коммит и правда всегда свежий.
Свежий — не значит верный. А проверить нечем.
Первое возражение
А если система большая?
Окно моделей — десятки тысяч строк. Биллинг или ERP — сотни тысяч, иногда миллионы.
Дело даже не в окне. Не собирается сквозная картина: сценарий идёт через модули, асинхронные стыки и настройку, и этой связности в коде нет.
Логи покажут, какими путями ходят чаще. Ранжировать помогут, проверить правильность — нет.
Как её пишут сегодня
Руками. Один раз. К сдаче.
Человек проходит сценарий, снимает копии экрана, вставляет в документ.
Потом система меняется, а документ — нет.
Почему же его не поправят
Потому что ничего не происходит
Неверная документация не роняет ни сборку, ни прод, не гасит лампочку, никого не будит ночью.
А пользователь звонит в поддержку — не автору руководства.
До автора сигнал не доходит вовсе.
Что должно случиться
Сценарий должен выполняться на работающей системе — и падать, когда разошёлся с ней
Такая штука давно есть и называется автотест.
Условие
Кто объявляет сценарий образцовым
Этого нет ни в коде, ни в логах: это решение, а не вычисление.
Разработчик, изменяя код, знает, как меняется сценарий. Записать его в автотест в эту минуту стоит почти ничего.
Сценарии пишут те же, кто пишет программу. Это и есть Кольцо Автотестов.
Парадокс
Кто пишет автотест — тот же, кто код?
Для человека — да: сценарий у него в голове ровно сейчас, передавать дорого.
Для агентов — нет: один пишет тесты, другой код, и они спорят, пока не сойдутся.
Цены поменялись местами. У людей дорога передача знания. У агентов она даром, зато нужнее независимость: кто пишет и код, и тест, напишет тест под свою реализацию.
Не делится одно — право сказать, что считается правильным.
Что из этого выросло
Один артефакт — пять применений
ТЗ
Сценарий действий, а не у каждого своё в голове.
Рефакторинг
Система растёт, сценарии продолжают работать.
Документация
Из того же прогона, с копиями экрана.
Нагрузка
Те же сценарии на объёмах.
Мониторинг
По расписанию на проде или его копии.
Сколько это стоит
+30%
Столько по нашей практике добавляет написание кода вместе с автотестами — а значит, и вместе с автодокументацией.
Платится один раз, на написании.
Насколько сожмёт ИИ эти тридцать процентов — вопрос открытый и самый интересный.
И при чём тут ИИ
Участок, который требовал человека
Из логирования прохождения автотеста в читаемый текст. Именно он делал затею менее выгодной. Теперь не требует.
И пишет уже пользовательским языком: по нескольким доступным примерам модель сама составляет себе ubiquitous language организации.
А из того же прогона получается и видеодокументация — теми же словами, только вслух.
Куда это ведёт
Рельсы для ИИ-поезда
Если по-матричному: не надо поручать людям машинную работу. Отсюда и «авто» в автодокументации. Человеческое — знать, что значит «правильно».
Guardrails мы переводим как «направляющие». И по смыслу это рельсы и есть: они не столько не дают съехать, сколько задают путь.
А первый кричал: «Куда хотим, туда едем
И можем, если надо, свернуть»
Второй отвечал, что поезд проедет
Лишь там, где проложен путь
Кольцо и есть проложенный путь.
Так сделаем мы эту сказку былью — или не в этот раз?
bush10.org/blog/ring-of-autotests/
Сергей Буш · Хардсофт321 · Lab321 GmbH, Берлин · t.me/BizOpsDev
