# build-model

Команда build-model строит план моделирования данных: трансформации, тесты, расписание деплоя и зависимости для аналитики.

- команда · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 450 у репозитория
- Автор: gtmagents
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/gtmagents/gtm-agents/tree/HEAD/plugins/analytics-pipeline-orchestration/commands/build-model.md
- Обновлён: 2026-04-03
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/build-model

## Что делает

Команда принимает метрику (`--use_case`), стек (`--stack`: dbt, LookML, SQL Runner, Python jobs), частоту обновления (`--refresh`: hourly, daily, weekly или cron) и генерирует спецификацию модели с staging-, intermediate- и mart-слоями, join-ключами, суррогатными ID. Определяет стратегию тестирования: проверки схемы, свежести данных, уникальности, допустимых значений и кастомные тесты. Строит план деплоя с конфигурацией ресурсов, стратегией backfill и шагами отката.

Результат сохраняется в `.claude/plans/plan-<timestamp>.json` с объективом, линейкой данных, матрицей зависимостей, обработкой ошибок и метриками успеха: процент свежести, потолок дефектов, соблюдение SLA. Если тестирование и подготовка деплоя могут идти параллельно, команда логирует diamond-сегмент с merge-воротами. Лимит повторов по умолчанию — 2 для упавших тестов; эскалация идёт к Analytics Modeling Lead → Data Engineering Lead → RevOps.

Команда вызывает агента `analytics-modeling-lead` для архитектуры модели, скилл `quality-gates` для покрытия валидациями, скилл `instrumentation` для контрактов данных. Выдаёт диаграмму модели, SQL-псевдокод, план тестирования, чеклист деплоя с хуками мониторинга и инструкциями отката.

## Установка

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

**Вручную: положить файлы**
- Файл: `.claude/commands/build-model.md` — Вызов — /build-model. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/build-model.md` — Вызов — /prompts:build-model. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/build-model.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/build-model.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gtmagents/gtm-agents/tree/HEAD/plugins/analytics-pipeline-orchestration/commands/build-model.md

## Когда брать
- спланировать трансформации данных для метрики или дашборда
- настроить тесты свежести, уникальности и схемы модели dbt
- составить расписание деплоя с backfill и откатом
- задокументировать зависимости модели и контракты данных
- подготовить план с метриками SLA и потолком дефектов

## Примеры запросов агенту
- Построй модель для метрики pipeline velocity в dbt с ежедневным обновлением: `/analytics-pipeline-orchestration:build-model --use_case "pipeline velocity" --stack "dbt" --refresh daily`
- Создай план модели для дашборда retention с почасовым refresh и зависимостью от таблицы `events`: `/analytics-pipeline-orchestration:build-model --use_case "retention dashboard" --stack "LookML" --refresh hourly --dependencies "events"`
- Спланируй Python-модель для еженедельной аналитики с тестами уникальности и accepted values

## Похожие
- [using-dbt-for-analytics-engineering](https://affpapa.org/nevibecode/skills/using-dbt-for-analytics-engineering.md) — скилл · 1200 установок
- [dbt-transformation-patterns](https://affpapa.org/nevibecode/skills/dbt-transformation-patterns.md) — скилл · 11000 установок
- [dbt-data-transformation](https://affpapa.org/nevibecode/skills/dbt-data-transformation.md) — скилл · 443 установки
- [analytics-engineer](https://affpapa.org/nevibecode/skills/analytics-engineer.md) — скилл · 207 установок
- [running-dbt-commands](https://affpapa.org/nevibecode/skills/running-dbt-commands.md) — скилл · 1100 установок
- [dbt Analytics Project taste](https://affpapa.org/nevibecode/prompts/dbt-analytics-project-taste.md) — промпт · ★ 178201 у репозитория

Из того же набора: [gtmagents/gtm-agents](https://affpapa.org/nevibecode/by/gtmagents/gtm-agents.md) — 224 карточки

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

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