# integration-engineer

Субагент integration-engineer для Claude Code планирует стыки между системами: вебхуки с ретраями, ETL, брокеры и EDI. Он работает с системами с разными моделями данных.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 489 у репозитория
- Автор: josstei
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/josstei/maestro-orchestrate/tree/HEAD/antigravity/src/agents/integration-engineer.md
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/integration-engineer

## Что делает

Субагент проектирует перекладывание данных между системами: исходящие вебхуки, входящие API, очереди и брокеры, пакетные ETL-задачи, EDI и плоские файлы. Его зона — стыки, где у двух систем разные модели данных, а потерянное сообщение обходится дорого.

Внутри набор решающих таблиц: матрица гарантий доставки (outbox, дедупликация по ключу идемпотентности, саги с компенсациями), правила ретраев с экспоненциальной задержкой и джиттером, порядок выката совместимых изменений схемы, чек-лист подключения B2B-партнёра и схема обработки EDI-файлов. Отдельный раздел — антипаттерны: публикация в брокер до коммита в базу, повтор 4xx, разбор сырого EDI на стороне потребителей. Файл кладут в `.claude/agents/` для Claude и в `.codex/agents/` с расширением `.toml` для Codex.

Ограничения жёсткие. В описании агента прямо стоит: без ключа идемпотентности и окна дедупликации интеграция не выпускается, консьюмер без dead-letter хранилища и плана replay не считается готовым, 4xx не ретраится никогда. Работает он в пределах `max_turns: 25` и на инструментах из `frontmatter`, включая `run_shell_command` и `write_file`. Результат он передаёт дальше: `data-engineer` нужна каноническая схема, `security-engineer` — модель аутентификации и ротация сертификатов.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/integration-engineer.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/integration-engineer.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/integration-engineer.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/josstei/maestro-orchestrate/tree/HEAD/antigravity/src/agents/integration-engineer.md

## Когда брать
- связать два сервиса с разными моделями данных через outbox
- собрать ETL-задачу с идемпотентным мержем и перезапуском
- разобрать входящий EDI 850 с SFTP и вернуть 997
- настроить ретраи и dead-letter для исходящего вебхука
- спрятать legacy-систему за антикоррупционным слоем

## Примеры запросов агенту
- Сделай исходящий вебхук из сервиса заказов партнёру с доставкой at-least-once
- Разбери входящие EDI 850 с SFTP в нашу модель заказа и отправь обратно 997
- Спроектируй ETL-джоб с идемпотентным мержем, чтобы он перезапускался после падения

## Похожие
- [data-engineer](https://affpapa.org/nevibecode/skills/daffy0208-data-engineer.md) — скилл · 181 установка
- [data-pipeline-engineer](https://affpapa.org/nevibecode/skills/data-pipeline-engineer.md) — скилл · 215 установок
- [sent-integration-starter](https://affpapa.org/nevibecode/skills/sent-integration-starter.md) — скилл · 2700 установок
- [webhook-integration](https://affpapa.org/nevibecode/skills/webhook-integration.md) — скилл · 1100 установок
- [configuring-exports](https://affpapa.org/nevibecode/skills/configuring-exports.md) — скилл · 4100 установок
- [webhook-engineer](https://affpapa.org/nevibecode/agents/webhook-engineer.md) — субагент · ★ 26718 у репозитория

Из того же набора: [josstei/maestro-orchestrate](https://affpapa.org/nevibecode/by/josstei/maestro-orchestrate.md) — 40 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
