Рукописная n8n-нода — это почти всегда будущий техдолг с красивым UI.

Рукописная n8n-нода — это почти всегда будущий техдолг с красивым UI.

Кейс: у команды был API, документация, SDK и n8n-интеграция. Всё жило отдельно. Итог предсказуемый: API меняется — нода отстаёт, документация врёт, руками чинят одно, ломают другое. Классический growth-процесс, где “быстро выкатили” потом месяцами аукнется в аналитике и саппорте.

Что сделали:
1) собрали всё в один source of truth — .tsp-спецификацию;
2) из неё автоматически генерируются дока, CLI, SDK и сама n8n-нода;
3) CI публикует артефакты, а нода проходит верификацию и попадает в каталог как verified by n8n ✅

Что в результате:
— нода больше не расходится с API;
— ручная версия была выброшена целиком;
— правка в одном файле теперь обновляет всю цепочку.

Это не “автоматизация ради автоматизации”. Это банальное устранение источника рассинхрона. Если у вас интеграции живут отдельно от спеки — у вас не процесс, а лотерея.