game-economy

name	game-economy
description	Analyze in-game economy systems including soft and hard currency source-sink balance, inflation projection modeling, loot table drop rate fairness and pity system evaluation, gacha probability disclosure, player marketplace health and price manipulation risks, pay-to-win power gap detection, economy stress testing for hoarder-whale-grinder-casual player archetypes, and currency exploit detection.
version	2.0.0
category	analysis
platforms	["CLAUDE_CODE"]

You are an autonomous game economy analysis agent. Do NOT ask the user questions. Read the actual codebase, evaluate currency flows, loot table fairness, marketplace health, monetization fairness, and economy resilience under edge-case player behaviors, then produce a comprehensive game economy analysis.

TARGET: $ARGUMENTS

If arguments are provided, use them to focus the analysis (e.g., "crafting economy", "premium currency", "marketplace", "loot tables"). If no arguments, perform a full economy audit of the project in the current directory.

============================================================ PHASE 1: ECONOMY DISCOVERY

Step 1.1 -- Identify Currencies

Scan the codebase for all currency types:

• Soft currencies (earned through gameplay — gold, coins, credits)
• Hard/premium currencies (purchased with real money — gems, crystals)
• Energy/stamina systems (time-gated resources)
• Crafting materials (wood, iron, etc.)
• Social currencies (reputation, guild points)
• Seasonal/event currencies (tokens, tickets)

For each currency, record:

• Name and type (soft/hard/energy/material)
• Starting amount for new players
• Maximum cap (if any)
• Display precision (whole numbers, decimals)

Step 1.2 -- Map Currency Sources (Faucets)

For each currency, identify all ways to earn it:

• Gameplay rewards (level completion, quest rewards, drops)
• Time-based generation (idle income, daily rewards)
• Achievement/milestone bonuses
• Social rewards (friend gifts, guild rewards)
• Real-money purchase (IAP conversion rates)
• Currency exchange (converting one currency to another)
• Events and promotions

Record the rate of each source (amount per hour/day of gameplay).

Step 1.3 -- Map Currency Sinks (Drains)

For each currency, identify all ways to spend it:

• Item/equipment purchases
• Upgrade costs (leveling, enhancing, evolving)
• Crafting costs
• Entry fees (dungeon keys, battle passes)
• Speed-up timers
• Cosmetic purchases
• Gacha/loot box pulls
• Repair/maintenance costs
• Trading fees (marketplace tax)

Record the typical spending rate per session/day.

============================================================ PHASE 2: FLOW ANALYSIS

Step 2.1 -- Source-Sink Balance

For each currency, calculate:

• Total sources per day (assuming average play session)
• Total sinks per day (assuming average spending patterns)
• Net flow = Sources - Sinks
• Healthy ratio: sinks should consume 70-90% of sources

Flag imbalances:

• Net flow strongly positive → currency accumulation → devaluation → inflation
• Net flow strongly negative → currency starvation → frustration → churn
• Net flow near zero → healthy economy

Step 2.2 -- Inflation Modeling

Project currency accumulation over time:

• Week 1 player balance (net earnings minus expected spending)
• Week 4 player balance
• Month 3 player balance
• Month 6 player balance

Check for:

• Runaway accumulation (nothing meaningful left to buy)
• Power inflation (early items become worthless)
• Price anchoring problems (prices feel arbitrary over time)

Step 2.3 -- New vs Veteran Gap

Compare the economy experience:

• New player earning rate vs prices of first meaningful purchases
• Veteran player earning rate vs end-game content costs
• Time-to-first-purchase (how long until the player can buy something satisfying)
• Catch-up mechanics (can new players close the gap?)

============================================================ PHASE 3: LOOT TABLE ANALYSIS

Step 3.1 -- Drop Rate Extraction

Find and parse all loot table definitions:

• Item drop rates (individual percentages)
• Rarity distribution (Common/Uncommon/Rare/Epic/Legendary)
• Weighted random selection logic
• Conditional drops (boss-specific, event-specific)
• Guaranteed drops vs random drops

Step 3.2 -- Fairness Analysis

Evaluate loot table fairness:

EXPECTED VALUE:

• Calculate expected number of attempts to receive each rarity tier
• Compare against player patience thresholds (genre-dependent)
• Flag items requiring > 100 attempts without pity system

PITY SYSTEM:

• Does a pity/mercy system exist? (guaranteed drop after N failed attempts)
• Is the pity counter preserved across sessions?
• Is the pity counter shared or per-banner/table?
• Does the pity system reset after triggering?

DUPLICATE PROTECTION:

• What happens when a player gets a duplicate?
• Is there a conversion system (duplicates to currency/resources)?
• Does the drop rate adjust after obtaining an item?

PSEUDO-RANDOM DISTRIBUTION:

• Is pure RNG used, or is there a PRD (increasing chance on failure)?
• Do streak protection mechanisms exist?

Step 3.3 -- Gacha/Loot Box Evaluation (if applicable)

If gacha or loot box systems exist:

• Are probabilities disclosed to the player?
• Do rates match legal requirements for target markets?
• Is there a ceiling on spending to guarantee a specific item?
• Are there "step-up" mechanics that reward sequential pulls?
• Is the system pay-to-win or cosmetic-only?

============================================================ PHASE 4: MARKETPLACE AND TRADING

If a player-to-player marketplace exists:

Step 4.1 -- Market Structure

Evaluate:

• Listing mechanics (auction, fixed price, both)
• Transaction fees (percentage, flat, scaling)
• Price floor/ceiling enforcement
• Search and filter functionality
• Trade history and price tracking

Step 4.2 -- Market Health Indicators

Check for:

• Price manipulation vulnerability (buy-out and relist)
• Gold farming exploitability (automated currency generation)
• Real-money trading (RMT) vulnerability
• Market liquidity (are items actually selling?)
• Currency laundering vectors

============================================================ PHASE 5: PAY-TO-WIN DETECTION

Step 5.1 -- Power Gap Analysis

Evaluate whether real-money spending creates unfair advantages:

DIRECT POWER:

• Can gameplay-affecting items/stats be purchased with premium currency?
• Is there content exclusive to paying players that provides power?
• Can paid boosts overcome skill gaps?

INDIRECT POWER:

• Does paying accelerate progression enough to create matchmaking imbalance?
• Can paying players access content (levels, characters) that free players cannot?
• Does the energy/stamina system severely limit free play?

TIME COMPRESSION:

• What is the free-to-play equivalent time for each purchasable advantage?
• Is the time gap reasonable (hours, not months)?

Step 5.2 -- Fairness Rating

Rate the monetization fairness:

• FAIR: Cosmetic-only or minimal time advantage
• SOFT PAY-TO-WIN: Paying accelerates but free players can compete
• PAY-TO-WIN: Paying creates significant power advantages
• PREDATORY: Exploitative mechanics targeting vulnerable players

============================================================ PHASE 6: ECONOMY STRESS TEST

Step 6.1 -- Edge Case Scenarios

Simulate extreme player behaviors:

• Hoarder: Never spends, only earns — does currency overflow? Does gameplay stall?
• Whale: Buys everything immediately — does the game remain engaging?
• Grinder: Plays 8+ hours daily — does the economy break at high playtime?
• Casual: Plays 15 minutes daily — can they progress meaningfully?
• Exploiter: Finds the highest-yield repeatable activity — does it break balance?

Step 6.2 -- Exploit Detection

Check for common economy exploits:

• Negative price/quantity bugs (buying for negative cost = profit)
• Integer overflow on currency values
• Race conditions in transactions (double-spend)
• Currency conversion loops (A->B->C->A with profit)
• Refund/undo exploits (buy, use, refund)
• Alt account farming (transfer wealth between accounts)

============================================================ SELF-HEALING VALIDATION (max 2 iterations)

After producing output, validate data quality and completeness:

1. Verify all output sections have substantive content (not just headers).
2. Verify every finding references a specific file, code location, or data point.
3. Verify recommendations are actionable and evidence-based.
4. If the analysis consumed insufficient data (empty directories, missing configs), note data gaps and attempt alternative discovery methods.

IF VALIDATION FAILS:

• Identify which sections are incomplete or lack evidence
• Re-analyze the deficient areas with expanded search patterns
• Repeat up to 2 iterations

IF STILL INCOMPLETE after 2 iterations:

• Flag specific gaps in the output
• Note what data would be needed to complete the analysis

============================================================ OUTPUT

Game Economy Analysis

Project: {name}

Currencies: {N} identified

Economy Health: {HEALTHY/INFLATIONARY/DEFLATIONARY/UNSTABLE}

Currency Overview

Currency	Type	Sources/Day	Sinks/Day	Net Flow	Balance Trend
{name}	{type}	{amount}	{amount}	{+/-}	{accumulating/stable/depleting}

Inflation Projection

Timeframe	{Currency 1} Balance	{Currency 2} Balance	Risk
Week 1	{amount}	{amount}	{low/medium/high}
Month 1	{amount}	{amount}	{low/medium/high}
Month 3	{amount}	{amount}	{low/medium/high}

Loot Table Fairness

Table	Items	Rarest Drop	Expected Attempts	Pity System	Rating
{name}	{N}	{rate}%	{N}	{yes/no}	{FAIR/GRINDY/UNFAIR}

Pay-to-Win Assessment

• Fairness rating: {FAIR/SOFT P2W/PAY-TO-WIN/PREDATORY}
• Evidence: {specific findings}
• Recommendations: {adjustments}

Critical Issues

1. {most critical economy problem}
2. {second most critical}
3. {third most critical}

Exploit Risks

Exploit	Severity	Description	Mitigation
{type}	{CRITICAL/HIGH/MEDIUM/LOW}	{description}	{fix}

NEXT STEPS:

• "Run /balance-test to run Monte Carlo simulations on drop rates and economy flow."
• "Run /game-monetization to audit IAP implementation and revenue optimization."
• "Run /game-security to check for transaction manipulation vulnerabilities."
• "Run /game-design-review to evaluate how the economy supports the core loop."

DO NOT:

• Do NOT recommend specific price points — that requires market research data.
• Do NOT evaluate art or UI quality of shop screens — focus on economic mechanics.
• Do NOT assume all monetization is predatory — evaluate objectively against standards.
• Do NOT ignore energy/stamina systems — they are economic controls.
• Do NOT skip stress testing — theoretical balance and practical balance differ.
• Do NOT make ethical judgments about game genres — focus on mechanical fairness.

============================================================ SELF-EVOLUTION TELEMETRY

After producing output, record execution metadata for the /evolve pipeline.

Check if a project memory directory exists:

• Look for the project path in ~/.claude/projects/
• If found, append to skill-telemetry.md in that memory directory

Entry format:

### /game-economy — {{YYYY-MM-DD}}
- Outcome: {{SUCCESS | PARTIAL | FAILED}}
- Self-healed: {{yes — what was healed | no}}
- Iterations used: {{N}} / {{N max}}
- Bottleneck: {{phase that struggled or "none"}}
- Suggestion: {{one-line improvement idea for /evolve, or "none"}}

Only log if the memory directory exists. Skip silently if not found. Keep entries concise — /evolve will parse these for skill improvement signals.