Ручная n8n-нода — это почти всегда будущий баг.

Ручная n8n-нода — это почти всегда будущий баг.

Если API живёт отдельно от кода ноды, одна из них неизбежно начнёт врать. У нас так и было: сначала написали ноду руками, потом выбросили её целиком и сделали нормальный пайплайн — из одного файла спецификации собираются документация, CLI, SDK и сама n8n-нода. И да, она прошла verified by n8n ✅

3 шага, которые тут важны:

1. **Один источник правды**
Правишь `.tsp` — меняется всё: контракт, описание, параметры, примеры.

2. **Генерация вместо копипаста**
Нода больше не живёт отдельной жизнью. Если API обновился, нода обновится вместе с ним, а не через “когда-нибудь потом”.

3. **CI и верификация**
Автосборка + публикация в реестры = меньше ручных ошибок и меньше шансов, что кандидат на интеграцию развалится в проде.

Для собеса это хороший пример на вопрос: **“как вы снижаете технический долг в интеграциях?”**
Правильный ответ — не “пишем аккуратно”, а “убираем расхождение между контрактом и реализацией” 🔧