optimize-referrals — команда для Claude Code: обзор и установка
Команда optimize-referrals анализирует воронку реферальной программы, риски фрода и активность партнёров, формируя план действий в Claude Code.
Apache-2.0 ★ 450 обновлён 2026-04-03
.claude/commands/optimize-referrals.mdЧто делает 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/
Вручную: положить файлы
~/.codex/prompts/optimize-referrals.mdВызов — /prompts:optimize-referrals. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/optimize-referrals.prompt.mdВручную: положить файлы
.gemini/commands/optimize-referrals.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы об 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