К основному содержанию
команда CX Codex

define-events — команда для Claude Code: что делает и как установить

Команда define-events генерирует спецификацию событий аналитики с полями, владельцами и планом тестирования. Помогает согласовать трекинг между продуктом, CDP и dbt.

Apache-2.0 ★ 450 обновлён 2026-04-03

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/define-events.md
Открыть на GitHub

Что делает define-events

Команда запускает оркестрацию разметки аналитики в пять этапов: сбор требований, каталогизация событий, правила нейминга и согласий, план контроля качества и управление релизами. На выходе формируется трекинг-план в форматах CSV, JSON или YAML, а также чеклист для QA с логами и дашбордами.

Вся структура фиксируется в файле .claude/plans/plan-<timestamp>.json. В план закладываются лимит в две попытки при провале тестов и цепочка эскалации от аналитика до RevOps.

Для корректной работы требуются субагент analytics-data-strategist и вспомогательные скиллы instrumentation и quality-gates. Без них связка не сможет автоматически валидировать схемы и проверять условия согласия на обработку данных.

Какие задачи решает

  • составить спецификацию трекинга для CDP и продуктовой аналитики
  • зафиксировать свойства событий, типы данных и владельцев
  • настроить чеклист проверки событий через юнит-тесты и логи
  • сохранить схему аудита и этапы внедрения в .claude/plans

Примеры запросов агенту

  • /analytics-pipeline-orchestration:define-events --use_case "pipeline velocity" --sources "product,crm" --tools "Segment,dbt"
  • /analytics-pipeline-orchestration:define-events --use_case "user onboarding" --sources "web,billing" --tools "Segment,Postgres"
  • /analytics-pipeline-orchestration:define-events --use_case "checkout funnel" --sources "product" --tools "Mixpanel" --timeline "2025-Q3"

Как установить define-events

Вручную: положить файлы

.claude/commands/define-events.md

Вызов — /define-events. Для всех проектов — ~/.claude/commands/

Вопросы о define-events

Как установить define-events в Claude Code?

Сохраните файл команды по пути .claude/commands/define-events.md. После этого вызов станет доступен в сессии Claude Code.

Что создаёт команда define-events?

Она генерирует трекинг-план в формате CSV, JSON или YAML, спецификацию с описанием свойств и владельцев событий, чеклист QA и план развёртывания в каталоге .claude/plans.

Что происходит при ошибках во время проверки разметки?

По умолчанию заложен лимит в два повторных прогона тестов. При повторных сбоях запускается эскалация: сначала к Analytics Data Strategist, затем к Data Engineering Lead и RevOps.

Исходный текст

define-events.md · Apache-2.0
---
name: define-events
description: Produces instrumentation specification with events, properties, owners, and QA steps.
usage: /analytics-pipeline-orchestration:define-events --use_case "pipeline velocity" --sources "product,crm" --tools "Segment,dbt"
---

# Command: define-events

## Inputs
- **use_case** – business question or KPI the events support.
- **sources** – data sources involved (product, web, CRM, MAP, billing).
- **tools** – instrumentation stack (CDP, product analytics, warehouse, dbt).
- **constraints** – optional legal/compliance requirements.
- **timeline** – optional delivery date.

### GTM Agents Pattern & Plan Checklist
> Mirrors GTM Agents orchestrator blueprint @puerto/plugins/orchestrator/README.md#112-325.

- **Pattern selection**: Instrumentation typically runs **pipeline** (requirements → catalog → governance → QA → change mgmt). If governance + QA can run parallel, log a **diamond** segment with merge gate in the plan header.
- **Plan schema**: Save `.claude/plans/plan-<timestamp>.json` capturing objective, data sources, task IDs, dependencies, context passing (schemas, privacy notes), error handling, and success metrics (coverage %, defect ceiling).
- **Tool hooks**: Reference `docs/gtm-essentials.md` stack (Serena for repo diffs, Context7 for platform/legal docs, Sequential Thinking for review flows, Playwright for front-end event QA when applicable).
- **Guardrails**: Default retry limit = 2 for QA failures; escalation ladder = Analytics Data Strategist → Data Engineering Lead → RevOps.
- **Review**: Run `docs/usage-guide.md#orchestration-best-practices-puerto-parity` before execution to confirm agents, dependencies, deliverables.

## Workflow
1. **Requirement Gathering** – clarify KPIs, dimensions, and downstream consumers.
2. **Event Cataloging** – list events, payloads, properties, IDs, sampling rate, ownership.
3. **Governance Mapping** – document naming conventions, consent handling, retention policies.
4. **QA Plan** – outline testing methods (unit tests, replay, observability dashboards).
5. **Change Management** – define review/approval steps, rollout plan, and version control.

## Outputs
- Instrumentation spec (event name, description, properties, source, owner, status).
- Tracking plan (CSV/JSON/YAML) aligned with CDP or analytics tool requirements.
- QA checklist + evidence plan (logs, dashboards, sample payloads).
- Plan JSON entry stored/updated in `.claude/plans` for audit trail.

## Agent/Skill Invocations
- `analytics-data-strategist` – leads requirements + governance.
- `instrumentation` skill – enforces schema + consent rules.
- `quality-gates` skill – defines QA expectations.

## GTM Agents Safeguards
- **Fallback agents**: document substitutes (e.g., BI Publisher covering QA) if specialists unavailable.
- **Escalation triggers**: if instrumentation defects or compliance blockers breach guardrails twice in 48h, escalate to Data + Legal leadership, triggering GTM Agents-style rip-cord.
- **Plan maintenance**: update plan JSON/change log whenever events, schemas, or governance rules change to keep analytics audit-ready.

---

© gtmagents · Apache-2.0 · gtmagents/gtm-agents

Похожие слэш-команды

Все слэш-команды по теме «Данные и базы» →
instrument-events amplitude Скилл instrument-events превращает YAML с кандидатами в события в план инструментирования: где именно в коде поставить вызовы трекинга и какие свойства передавать. CX Codex +1 65 900установок measure-instrumentation-spec product-on-purpose Скилл measure-instrumentation-spec описывает события аналитики, условия их отправки и свойства. Запускайте его перед разработкой функции или при проверке существующего трекинга. CX Codex +1 835установок troubleshooting-dbt-job-errors dbt-labs Скилл troubleshooting-dbt-job-errors для Claude Code разбирает сбои dbt Cloud по логам, Admin API, истории коммитов и запросам к данным. Запускается, если сообщение об ошибке не объясняет причину. CX Codex +1 1 100установок dbt Analytics Project taste f Промпт dbt Analytics Project taste для ChatGPT задаёт правила устройства dbt-проекта с моделями staging, intermediate и marts. Включается при проектировании моделей, тестов и CI для аналитики. GP ChatGPT ★ 178 201звёзд репо devrel-analytics Samuel Berthe Скилл devrel-analytics для Claude Code строит план аналитики DevRel: события, источники, идентификаторы и воронки. Связывает посещения документации с регистрациями и объясняет расхождения метрик. CX Codex +1 13 500установок analytics-tracking kostja94 Скилл analytics-tracking указывает на актуальные инструкции Open Analytics по событиям GA4, ключевым событиям и User-ID. Нужен при переходе со старого пути скилла. CX Codex +1 2 500установок

Из того же набора224

Весь набор →
plan-plays Команда plan-plays строит ABM-роадмап по тирам: подбирает плеи, каналы и сроки под цели кампании и записывает план в JSON. CX Codex +1 ★ 450звёзд репо social-calendar-system Скилл social-calendar-system для Claude Code задаёт структуру контент-плана для соцсетей, этапы согласования и контроль публикаций. CX Codex +1 ★ 450звёзд репо distribute-assets Команда distribute-assets для Claude Code распределяет кампанию по каналам и готовит план публикаций, продвижения и измерения. Согласует сроки, партнёров и UTM-метки. CX Codex +1 ★ 450звёзд репо monitor-loyalty Команда monitor-loyalty для оценки здоровья программы лояльности: отслеживает вовлечённость участников, риски оттока и результаты экспериментов. Помогает выявить проблемные сегменты и возможности роста. CX Codex +1 ★ 450звёзд репо define-profiles Команда define-profiles для Claude Code описывает схемы профилей аудитории, источники данных и требования к активации. Задача — персонализация по нескольким каналам. CX Codex +1 ★ 450звёзд репо optimize-nurture Команда optimize-nurture для Claude Code собирает план улучшения nurture-коммуникаций по метрикам и сегментам. Анализирует результаты тестов и превращает выводы в задачи с ответственными и сроками. CX Codex +1 ★ 450звёзд репо co-plan-campaign Команда co-plan-campaign формирует совместный маркетинговый бриф с целями, аудиторией, каналами и зонами ответственности между компаниями-партнёрами. CX Codex +1 ★ 450звёзд репо implement-actions Команда implement-actions превращает приоритетную инициативу по клиентскому пути в план работ с ответственными, сроками, метриками и контролем выполнения. Подходит для координации маркетинга, продукта и других команд. CX Codex +1 ★ 450звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой