billing-behaviors

Original：🇺🇸 English
Translated

Commet behavior rules and business logic. Use when implementing billing features, subscription changes, plan changes, proration, pricing, credits, balance, intro offers, or any billing edge case. Contains detailed rules for how changes affect customers.

3installs
Sourcecommet-labs/commet-skills
Added on

NPX Install

npx skill4agent add commet-labs/commet-skills billing-behaviors

Tags

Translated version includes tags in frontmatter
billing-systemsubscription-managementpricing-rulesbusiness-logicsaas-billing

SKILL.md Content

View Translation Comparison →

Billing Behavior Rules

This skill contains the detailed business behavior rules for Commet. Load the specific files you need based on the task.

Core Principle

Commet does what's fair by default:
Change TypeWhen Applied
Benefits customerImmediately
Hurts customerAt renewal
Benefits customer: More limits (API calls, storage), adding features, more included seats. Hurts customer: Price increase, reduced limits, removing features, fewer included seats.

Actors

ActorWhere They ActExamples
FounderDashboardChange prices, edit features, deprecate plans
CustomerCustomer PortalUpgrade, downgrade, change billing interval
SystemAutomaticTrial end, payment failure, billing

Decision Tree

Who makes the change?
│
├─ FOUNDER (Dashboard)
│   ├─ Benefits customer? → IMMEDIATE
│   └─ Hurts customer? → AT RENEWAL
│   └─ Delete plan/customer? → See references/plan-management.md
│
└─ CUSTOMER (Portal)
    ├─ Upgrade (more expensive)? → IMMEDIATE + proration
    └─ Downgrade (cheaper)? → AT RENEWAL

Detailed Rules

Each file covers a specific aspect of billing behavior:
  • references/subscription-changes.md - Upgrades, downgrades, interval changes, proration by consumption model
  • references/pricing-changes.md - Base price, overage, and seat price changes
  • references/feature-changes.md - Limit increases/decreases, boolean features, included seats
  • references/plan-management.md - Deprecating and deleting plans, deleting customers
  • references/intro-offer.md - Introductory offer eligibility, components, plan change behavior
  • references/consumption-models.md - Credits and balance proration, plan changes, cancellation, purchases
  • references/edge-cases.md - Trial pricing, reactivations, payment failures, exhaustion, currency at checkout

Domain Reference

Module-specific knowledge for understanding the codebase:
  • references/domain-billing-engine.md - Billing engine orchestration, calculator resolution, processing flow, invoice line types, monthly resets
  • references/domain-subscriptions.md - Subscription states, creation flow, billing period, currency, trials, pause, cancellation
  • references/domain-plans.md - Plan structure, free vs paid, PlanPrice, PlanFeature, introductory offers, regional pricing
  • references/domain-features.md - Feature types (boolean, metered, seats), feature codes as SDK identifiers
  • references/domain-usage.md - Consumption models (metered, credits, balance), usage events, AI token tracking, subscription balance
  • references/domain-seats.md - Seat billing (advance + true-up), proration, seat types, SDK integration
  • references/domain-customers.md - Customer fields, external ID, address, customer credits, business flow
  • references/domain-plan-groups.md - Plan grouping for upgrades/downgrades, business rules
  • references/domain-addons.md - Addon system, activation/deactivation, billing, consumption model compatibility
  • references/domain-ai-costs.md - AI model catalog, token cost tracking, margin pricing, balance deductions
  • references/domain-promo-codes.md - Promo code system, validation rules, checkout flow, mutual exclusivity with intro offers