Skip to main content
command CX Codex

plan-loyalty — Claude Code command: what it does, how to install

plan-loyalty generates a loyalty program blueprint with tier structures, customer incentives, and lifecycle triggers within a set budget.

Apache-2.0 ★ 450 updated 2026-04-03

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/plan-loyalty.md
Open on GitHub

What plan-loyalty does

The command guides loyalty architecture across five steps: reviewing churn and cohort revenue, drafting tier mechanics, embedding triggers into customer journeys, modeling program economics, and assigning governance owners. The resulting architecture is saved to .claude/plans/plan-<timestamp>.json alongside dependencies across finance, legal, and operations.

Execution relies on specialized agents: loyalty-strategist, loyalty-modeling, and member-insights-analyst. The workflow coordinates tools from docs/gtm-essentials.md, using Serena for catalog diffs, Context7 for compliance docs, Sequential Thinking for scenarios, and Playwright for redemption flow verification.

A repeated negative ROI projection or legal roadblock triggers an escalation ladder directly to finance and the executive sponsor.

What it helps with

  • design loyalty tier requirements, earn rules, and member benefits
  • map automated loyalty triggers into onboarding and renewal touchpoints
  • model cost per point, breakage assumptions, and program break-even timing
  • record operational dependencies and audit trails in structured plan files

Example prompts for the agent

  • /loyalty-lifecycle-orchestration:plan-loyalty --goal retention --tiers 3 --budget 50000
  • /loyalty-lifecycle-orchestration:plan-loyalty --goal expansion --tiers hybrid --budget 80000 --personas "enterprise, mid-market"
  • /loyalty-lifecycle-orchestration:plan-loyalty --goal engagement --tiers missions --budget 20000 --constraints "GDPR compliance"

How to install plan-loyalty

Manually: put the files in place

.claude/commands/plan-loyalty.md

Call it with /plan-loyalty. For all projects use ~/.claude/commands/

Questions about plan-loyalty

How to install plan-loyalty in Claude Code?

Add the command file directly to .claude/commands/plan-loyalty.md inside your repository.

What does plan-loyalty do?

It outputs a loyalty blueprint table, a lifecycle trigger matrix, and an economic model summarizing reward costs and expected lift.

Where does the command store audit records?

It writes plan parameters and change logs directly to .claude/plans/plan-<timestamp>.json.

Source text

plan-loyalty.md · Apache-2.0
---
name: plan-loyalty
description: Produces loyalty program blueprint with tiers, benefits, and lifecycle triggers.
usage: /loyalty-lifecycle-orchestration:plan-loyalty --goal retention --tiers 3 --budget 50000
---

# Command: plan-loyalty

## Inputs
- **goal** – retention | expansion | engagement | advocacy.
- **tiers** – number of tiers or type (points-only, hybrid, missions).
- **budget** – monthly/quarterly reward pool.
- **personas** – optional comma-separated member segments.
- **constraints** – optional compliance or platform notes.

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

- **Pattern selection**: Loyalty design generally follows a **diamond** (research ↔ modeling in parallel, converge into governance) or **pipeline** if run sequentially; document choice in the plan header.
- **Plan schema**: Save `.claude/plans/plan-<timestamp>.json` capturing tiers, benefit assumptions, financial guardrails, dependency graph (legal, finance, ops), error handling, and success criteria (retention, NRR, cost/point).
- **Tool hooks**: Reference `docs/gtm-essentials.md` stack—Serena for catalog/tier diffs, Context7 for compliance docs, Sequential Thinking for scenario modeling, Playwright for testing redemption flows.
- **Guardrails**: Default retry limit = 2 for data pulls or modeling errors; escalation ladder = Loyalty Strategist → Finance/Legal → Exec sponsor.
- **Review**: Run `docs/usage-guide.md#orchestration-best-practices-puerto-parity` before publishing to ensure dependencies, approvals, and deliverables are logged.

## Workflow
1. **Signal Review** – pull churn metrics, cohort revenue, product usage, and VOC insights.
2. **Tier & Benefit Design** – outline requirements per tier (earn rules, benefits, surprise moments).
3. **Lifecycle Mapping** – embed loyalty triggers into onboarding, adoption, upsell, and renewal stages.
4. **Economic Modeling** – estimate cost per point, breakage, and projected ROI.
5. **Governance Packet** – assign owners, cadences, and KPIs for launch.

## Outputs
- Program blueprint deck/table (tiers, requirements, benefits, KPIs).
- Lifecycle trigger matrix (event → loyalty action → channel → owner).
- Financial model summary (cost, expected lift, break-even timeline).
- Plan JSON entry stored/updated in `.claude/plans` for audit trail.

## Agent/Skill Invocations
- `loyalty-strategist` – leads architecture.
- `loyalty-modeling` skill – calculates economics and guardrails.
- `member-insights-analyst` – validates segment assumptions.

## GTM Agents Safeguards
- **Fallback agents**: document substitutes (e.g., loyalty-ops covering strategist) when key approvers unavailable.
- **Escalation triggers**: escalate if modeling shows negative ROI twice or compliance blockers arise; follow GTM Agents rip-cord path and log in plan JSON.
- **Plan maintenance**: update plan JSON/change log whenever tiers, budgets, or guardrails shift so audit reviewers see history.

---

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

Similar slash commands

All slash commands for Marketing and content →

From the same set224

The whole set →
cold-email-specialist cold-email-specialist finds a recent hook on a prospect and builds a 50-90 word cold email around it. Handy when a generic template is not going to land. CX Codex ★ 450repo stars qualify-lead qualify-lead scores buyer fit and intent signals to determine whether sales teams should route, nurture, or recycle an account. CX Codex +1 ★ 450repo stars technical-seo This skill guides technical SEO checks for crawl and index problems, performance regressions, and structured data gaps. Use it when reviewing a site migration or investigating SEO issues. CX Codex +1 ★ 450repo stars creative-iteration-playbook creative-iteration-playbook turns social creative work into briefs, test matrices, a production pipeline and stop thresholds for paid campaigns. CX Codex +1 ★ 450repo stars manage-production The manage-production command turns a campaign and its assets into a production tracker with owners, review steps, and QA. Use it to plan work across several deliverables. CX Codex +1 ★ 450repo stars design-referral design-referral is a Claude Code command that designs referral programs with incentives, rules, and governance, producing a charter, stakeholder deck, and risk log. CX Codex +1 ★ 450repo stars design-nurture design-nurture builds multi-stage nurture journey blueprints with audience segmentation, triggers, and a content plan. Useful for planning lifecycle marketing and RevOps campaigns. CX Codex +1 ★ 450repo stars run-launch The run-launch command builds a launch execution plan with a timeline, communications, monitoring, and go/no-go gates. Use it to coordinate channel work and launch-day operations. CX Codex +1 ★ 450repo stars

Project sponsors

Companies that keep this analytics open