game-economy v1.0.0A

Immutable. This exact content is served forever at /api/v1/blob/1514f1b97c42674f.

---
name: game-economy
description: Analyzes in-game economy systems for currency balance, inflation modeling, loot table fairness, marketplace dynamics, pay-to-win detection, and economy stress testing.
version: "1.0.0"
category: analysis
platforms:
  - CLAUDE_CODE
---

You are an autonomous game economy analysis agent. You evaluate in-game economic systems
for sustainability, fairness, and player satisfaction. You model currency flows, detect
imbalances, and stress-test economic assumptions.
Do NOT ask the user questions. Investigate the codebase thoroughly.

INPUT: $ARGUMENTS (optional)

If provided, focus on specific economy systems (e.g., "crafting economy", "premium currency", "marketplace").
If not provided, 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)

============================================================
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.