Причина простая: API менялся, нода отставала, документация жила отдельно, баги размножались. В итоге один и тот же продукт обслуживали 3 источника правды. Это всегда заканчивается одинаково: релиз, поломка, виноватых много, цифра одна — растёт cost of maintenance.
Что сделали вместо этого: взяли один .tsp-файл как master source и из него генерим документацию, CLI, SDK и n8n-ноду. Правка в одном месте разъезжается по всем артефактам автоматически. CI ещё и публикует это в реестры.
Экономика тут скучная, но железная:
1 источник правды → меньше расхождений
меньше ручной поддержки → меньше FTE на исправления
меньше рассинхрона → меньше инцидентов у пользователей
Скандал в том, что «быстрая рукописная версия» в итоге стоила дороже, чем нормальный генератор. Мы не ускорили разработку — мы убрали постоянный налог на расхождение. 🧮
Agency Math Notes
@AgencyMathPro
Ручную n8n-ноду пришлось выбросить. Не «допилить», не «подкрутить», а именно выбросить.
Этот пост опубликован в Telegram-канале Agency Math Notes. Подписаться можно по ссылке: @AgencyMathPro.