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

optimize-referrals — команда для Claude Code: обзор и установка

Команда optimize-referrals анализирует воронку реферальной программы, риски фрода и активность партнёров, формируя план действий в Claude Code.

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

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

Что делает optimize-referrals

Команда запускает диагностику реферальной программы по цепочке из пяти шагов: сбор данных, аудит воронки, проверка рисков, оценка вовлечённости партнёров и подготовка гипотез. При вызове задаются горизонт анализа (7d, 30d или 90d), формат вывода (summary либо full) и срезы по каналам, персонам или партнёрским уровням.

Результаты работы команда сохраняет в аудит-лог .claude/plans/plan-<timestamp>.json. В файл попадают граф зависимостей, пороги эскалации и метрики успеха, включая снижение фрода и партнёрский NPS. Процесс опирается на смежных агентов: referral-architect приоритизирует тесты, lifecycle-ops готовит изменения коммуникаций, а навыки fraud-detection и partner-ops отвечают за проверку транзакций и связь с партнёрами.

Для защиты от сбоев установлен лимит повторов: при ошибке выгрузки данных или работы модели фрода выполняется не более двух попыток. Если контрольный порог метрик нарушен дважды подряд, запускается прямая эскалация к спонсору программы.

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

  • Оценить конверсию реферальной воронки от инвайтов до выручки
  • Выявить подозрительные когорты с помощью эвристик фрода
  • Проверить эффективность выплат и бонусов по уровням партнёров
  • Сформировать бэклог экспериментов с прогнозом прироста метрик

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

  • /referral-program-orchestration:optimize-referrals --window 30d --detail full --dimensions "channel,partner-tier"
  • /referral-program-orchestration:optimize-referrals --window 90d --detail summary --alert_threshold 0.05
  • /referral-program-orchestration:optimize-referrals --window 7d --experiments "tier-boost,instant-payout"

Как установить optimize-referrals

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

.claude/commands/optimize-referrals.md

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

Вопросы об optimize-referrals

Как установить команду optimize-referrals в Claude Code?

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

Что делает команда optimize-referrals?

Она вычисляет отдачу от рефералов, проверяет риски через скилл fraud-detection и предлагает план экспериментов с оценкой влияния на выручку.

Куда записываются планы оптимизации и аудит-логи?

Команда генерирует файл .claude/plans/plan-<timestamp>.json, куда заносит задачи, пороги эскалаций и метрики конверсии.

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

optimize-referrals.md · Apache-2.0
---
name: optimize-referrals
description: Analyzes referral performance, fraud risk, and partner health to recommend improvements.
usage: /referral-program-orchestration:optimize-referrals --window 30d --detail full --dimensions "channel,partner-tier"
---

# Command: optimize-referrals

## Inputs
- **window** – analysis horizon (7d, 30d, 90d).
- **detail** – summary | full to control output length.
- **dimensions** – optional breakdowns (channel, persona, partner-tier, region).
- **experiments** – optional list of tests to evaluate.
- **alert_threshold** – optional KPI threshold for escalations.

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

- **Pattern selection**: Optimization review typically runs **pipeline** (data refresh → diagnostics → risk review → partner health → action plan). If diagnostics + risk review can run concurrently, note a **diamond** block with merge gate in the plan header.
- **Plan schema**: Save `.claude/plans/plan-<timestamp>.json` capturing window, datasets, task IDs, dependency graph (BI, fraud, partner ops), error handling, and success metrics (conversion lift, fraud reduction, partner NPS).
- **Tool hooks**: Reference `docs/gtm-essentials.md` stack—Serena for schema diffs, Context7 for referral SOPs/partner comms, Sequential Thinking for retro cadence, Playwright for offer flows or portal QA.
- **Guardrails**: Default retry limit = 2 for failed data pulls or fraud model runs; escalation ladder = Referral Architect → Partner Ops → Exec sponsor.
- **Review**: Run `docs/usage-guide.md#orchestration-best-practices-puerto-parity` before distributing recommendations to confirm dependencies and approvals.

## Workflow
1. **Data Refresh** – pull referral submissions, conversions, payouts, fraud flags, and NPS per dimension.
2. **Performance Diagnostics** – inspect funnel (invites → referrals → pipeline → revenue) and incentive efficiency.
3. **Risk Review** – run fraud heuristics, identify suspicious cohorts, confirm compliance logs.
4. **Partner Health** – evaluate top/bottom partners, share-of-voice, and engagement levels.
5. **Playbook Output** – recommend experiments (incentive tweaks, messaging, partner enablement) with expected impact.

## Outputs
- Performance dashboard snapshot with annotated insights.
- Fraud/risk summary referencing `fraud-detection` skill outputs.
- Optimization backlog with owners, ETA, and projected lift.
- Plan JSON entry stored/updated in `.claude/plans` for audit trail.

## Agent/Skill Invocations
- `referral-architect` – prioritizes experiments + approvals.
- `lifecycle-ops` – implements tooling or messaging changes.
- `fraud-detection` skill – validates risk findings.
- `partner-ops` skill – coordinates partner communications.

## GTM Agents Safeguards
- **Fallback agents**: document substitutes (e.g., Lifecycle Ops covering Architect) when leads unavailable.
- **Escalation triggers**: if alert_threshold breached twice or fraud risk spikes, trigger GTM Agents rip-cord escalation and record actions in plan JSON.
- **Plan maintenance**: update plan JSON/change log whenever metrics, thresholds, or partner tiers change to maintain audit continuity.

---

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

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

Все слэш-команды по теме «Маркетинг и контент» →
referrals coreyhaines31 Скилл referrals для Claude Code помогает спроектировать реферальную или партнёрскую программу. Он включается, когда нужно выбрать вознаграждение, настроить механику рекомендаций или оценить конверсию. CX Codex +1 83 500установок referrals-word-of-mouth RefoundAI Скилл referrals-word-of-mouth для Claude Code и Codex превращает случайное сарафанное радио в реферальную программу и вирусные петли продукта. Работает, когда органический рост уже идёт и его нужно усилить. CX Codex +1 435установок suede-referrals JasonColapietro Скилл suede-referrals проектирует реферальные и партнёрские программы, рассчитывает вознаграждения от LTV и настраивает защиту от фрода. CX Codex +1 ★ 121звёзд репо optimize davila7 Команда optimize анализирует активные и прошедшие оркестрации задач в Claude Code, находит узкие места и перераспределяет нагрузку между агентами. CX Codex +1 440установок multi-agent-optimize Seth Hobson Команда multi-agent-optimize помогает найти узкие места в мультиагентной системе и настроить контекст, координацию и расходы. Запускайте её, когда нужно сопоставить производительность, стоимость и качество. CX Codex +1 ★ 42 780звёзд репо affiliate-fraud-detection Maya-Beth Finotti Скилл affiliate-fraud-detection помогает составить правила детекции фрода в партнёрских программах B2B SaaS и e-commerce, настроить окно холда выплат и регламент расследований. CX Codex +1 17 600установок

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

Весь набор →
run-standups Команда run-standups собирает ежедневный статус по воронке MQL→SQL: метрики, блокеры и действия для revops, маркетинга и продаж. CX Codex +1 ★ 450звёзд репо connect-signals Команда connect-signals настраивает сбор сигналов намерений, продуктовой аналитики и вовлечённости с выгрузкой схем в хранилище. CX Codex +1 ★ 450звёзд репо track-source Команда track-source для Claude Code собирает данные партнёрской кампании и формирует отчёт с атрибуцией, вкладом в выручку и рекомендациями для совместного маркетинга. CX Codex +1 ★ 450звёзд репо manage-assets Команда manage-assets для управления производством, согласованием и распределением совместно-брендированных материалов между партнёрами. Упорядочивает процесс утверждений, ведёт реестр активов и готовит пакеты для активации. CX Codex +1 ★ 450звёзд репо synthesize-feedback Команда synthesize-feedback для Claude Code собирает отзывы и метрики в темы с оценкой влияния и приоритетов. Готовит материалы для решений по обратной связи клиентов. CX Codex +1 ★ 450звёзд репо define-handoff Команда define-handoff для проектирования передачи лидов от маркетинга в продажи: определяет правила роутинга, времена ответа и требования к включению команды. CX Codex +1 ★ 450звёзд репо monitor-personalization Команда monitor-personalization аудирует результаты экспериментов персонализации, проверяет соблюдение правил согласия и строит план действий при аномалиях. CX Codex +1 ★ 450звёзд репо editorial-ops Скилл editorial-ops для Claude Code, который берёт на себя планирование многоканального редакционного календаря и координацию производственного цикла контента. CX Codex +1 ★ 450звёзд репо

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

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