trade-promotion-roi
Trade promotion ROI evaluation with netROI gate
- License 许可
- AGPL-3.0
- 最近更新
- 2026-11-14
- Stars
- ★ 25
- Forks
- 9
01 前言 Front Matter
- name
- trade-promotion-roi
- owner
- market-intelligence-analyst
- scope
- co-price
- status
- active
- version
- 1.0.0
- description
- Trade promotion ROI evaluation with netROI gate
- last_reviewed
- 1787616000000
- prerequisites
- two snapshots (no-promotion baseline vs promoted) re-simulated; spendByMonth actuals reconciled to deductions
03 SKILL.md 正文
Trade Promotion ROI Skill (Cycle Stage 8 → next 0–2)
Purpose
Close the TPM/TPO loop with honest numbers: gross ROI flatters by 30%+ when the post-promo dip, cannibalization and forward-buying are ignored. This skill produces the net figures and the outcome classification that drive repeat-or-kill decisions.
Procedure
- Freeze the pair — baseline = no-promotion snapshot; policy = promoted snapshot. Re-simulate both through the live engine (never reuse stale results).
- Reconcile spend — match every deduction (scan-downs, bill-backs, display
fees) to the event;
spendByMonthmust reflect ACTUALS, not planned budget. - Evaluate —
evaluatePromotionEvent({ baselinePath, promoPath, windowMonths, postWindowMonths: 2, spendByMonth, contributionRate, siblingDeltaRevenue?, sellInSpikeWithoutSellOut? }).- Scan-down structure note: allowance is paid on ALL window units, so include
it in
spendByMonthacross the full window, not only incremental units. - Incremental COGS applies to incremental units only — handled via the contribution-rate basis on promo-window revenue.
- Scan-down structure note: allowance is paid on ALL window units, so include
it in
- Classify & prescribe — per §11.5:
Outcome Next action true_incremental repeat at same/adjusted depth if ROI ≥ hurdle (2.0) forward_buying_suspected shorten window, shift to scan-based mechanics cannibalization-corrected portfolio calendar re-plan, SKU swap insufficient_data fix measurement before spending again - Hand off — ledger-register every figure; route the memo through
insight-synthesisfor the next-cycle direction.
Boundaries
- Net ROI > 2.5 ⇒ re-audit the baseline before celebrating (
PROMO-TOO-GOOD). - Sell-in ≠ sell-out: shipment spikes are not consumer demand.
- The repeat-or-kill decision itself belongs to humans (engagement-director gate).
Context
See docs/co-price.context.md for project context and the consulting engagement lifecycle.
When to Use
- When a co-price task requires Trade promotion ROI evaluation with netROI gate within the engagement lifecycle.
Execution Steps
- Receive dispatch from PM with task parameters and document anchors.
- Execute the skill procedure against the artifacts named in the task scope.
- Report results to the dispatching agent with evidence links.
Output Format
Structured markdown report delivered to the dispatching agent, citing document anchors (for example [Ref: biz_logic.*]) where applicable.
Related Skills
- Owner agent:
market-intelligence-analyst. Seevariant.jsonskills registry for the full co-price skill set.
04 同仓库更多 Skills
i18n-layout
Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL/bidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF/BOM issues surface.
i18n-layout
Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL/bidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF/BOM issues surface.
i18n-layout
Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL/bidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF/BOM issues surface.
i18n-layout
Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL/bidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF/BOM issues surface.
i18n-layout
Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL/bidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF/BOM issues surface.
i18n-layout
Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL/bidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF/BOM issues surface.