claude-code-arcane 1.0.0

package/templates/gamedev/economy-model.md

@@ -0,0 +1,130 @@
+# Economy Model: [System Name]
+
+*Created: [Date]*
+*Owner: economy-designer*
+*Status: [Draft / Balanced / Live]*
+
+---
+
+## Overview
+
+[What resources, currencies, and exchange systems does this economy cover?
+What player behaviors does it incentivize?]
+
+---
+
+## Currencies
+
+| Currency | Type | Earn Rate | Sink Rate | Cap | Notes |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| [Gold] | Soft | [per hour] | [per hour] | [max or none] | [Primary transaction currency] |
+| [Gems] | Premium | [per day F2P] | [varies] | [max] | [Premium currency, purchasable] |
+| [XP] | Progression | [per action] | [level-up cost] | [none] | [Cannot be traded] |
+
+### Currency Rules
+- [Rule 1 — e.g., "Soft currency has no cap but inflation is controlled via sinks"]
+- [Rule 2 — e.g., "Premium currency cannot be converted back to real money"]
+- [Rule 3]
+
+---
+
+## Sources (Faucets)
+
+| Source | Currency | Amount | Frequency | Conditions |
+| ---- | ---- | ---- | ---- | ---- |
+| [Quest completion] | Gold | [50-200] | [per quest] | [Scales with quest difficulty] |
+| [Enemy drops] | Gold | [1-10] | [per kill] | [Modified by luck stat] |
+| [Daily login] | Gems | [5] | [daily] | [Streak bonus: +1 per consecutive day] |
+| [Achievement] | XP | [100-500] | [one-time] | [Per achievement tier] |
+
+---
+
+## Sinks (Drains)
+
+| Sink | Currency | Cost | Frequency | Purpose |
+| ---- | ---- | ---- | ---- | ---- |
+| [Equipment purchase] | Gold | [100-5000] | [as needed] | [Power progression] |
+| [Repair costs] | Gold | [10-100] | [per death] | [Death penalty, gold drain] |
+| [Cosmetic shop] | Gems | [50-500] | [optional] | [Vanity, premium sink] |
+| [Respec] | Gold | [1000] | [rare] | [Build experimentation tax] |
+
+---
+
+## Balance Targets
+
+| Metric | Target | Rationale |
+| ---- | ---- | ---- |
+| Time to first meaningful purchase | [X minutes] | [Player should feel spending power early] |
+| Hourly gold earn rate (mid-game) | [X gold/hr] | [Based on session length and purchase cadence] |
+| Days to max level (F2P) | [X days] | [Enough to retain, not so long it frustrates] |
+| Sink-to-source ratio | [0.7-0.9] | [Slight surplus keeps players feeling wealthy] |
+| Premium currency F2P earn rate | [X/week] | [Enough to buy something monthly, not everything] |
+
+---
+
+## Progression Curves
+
+### Level XP Requirements
+| Level | XP Required | Cumulative XP | Estimated Time |
+| ---- | ---- | ---- | ---- |
+| 1→2 | [100] | [100] | [10 min] |
+| 5→6 | [500] | [1,500] | [2 hrs] |
+| 10→11 | [1,500] | [7,500] | [8 hrs] |
+| 20→21 | [5,000] | [50,000] | [40 hrs] |
+
+*Formula*: `XP(n) = [formula, e.g., 100 * n^1.5]`
+
+### Item Price Scaling
+*Formula*: `Price(tier) = [formula, e.g., base_price * 2^(tier-1)]`
+
+---
+
+## Loot Tables
+
+### [Drop Source Name]
+| Item | Rarity | Drop Rate | Pity Timer | Notes |
+| ---- | ---- | ---- | ---- | ---- |
+| [Common item] | Common | [60%] | [N/A] | [Always useful, never feels bad] |
+| [Uncommon item] | Uncommon | [25%] | [N/A] | [Noticeable upgrade] |
+| [Rare item] | Rare | [12%] | [10 drops] | [Exciting, build-defining] |
+| [Legendary item] | Legendary | [3%] | [30 drops] | [Game-changing, celebration moment] |
+
+### Pity System
+[Describe how the pity system works to prevent extreme bad luck streaks.]
+
+---
+
+## Economy Health Metrics
+
+| Metric | Healthy Range | Warning Threshold | Action if Breached |
+| ---- | ---- | ---- | ---- |
+| Average player gold | [X-Y at level Z] | [>Y or <X] | [Adjust faucets/sinks] |
+| Gold Gini coefficient | [<0.4] | [>0.5] | [Wealth too concentrated] |
+| % players hitting currency cap | [<5%] | [>10%] | [Raise cap or add sinks] |
+| Premium conversion rate | [2-5%] | [<1% or >10%] | [Rebalance F2P earn rate] |
+| Average time between purchases | [X minutes] | [>Y minutes] | [Nothing worth buying] |
+
+---
+
+## Ethical Guardrails
+
+- [No pay-to-win: premium currency cannot buy gameplay power advantages]
+- [Pity timers on all random drops: guaranteed outcome within X attempts]
+- [Transparent drop rates displayed to players]
+- [Spending limits for minor accounts]
+- [No artificial scarcity pressure (FOMO timers) on essential items]
+
+---
+
+## Simulation Results
+
+[Include results from economy simulations if available: player wealth
+distribution over time, sink effectiveness, inflation rate, etc.]
+
+---
+
+## Dependencies
+
+- Depends on: [combat balance, quest design, crafting system]
+- Affects: [difficulty curve, player retention, monetization]
+- Must coordinate with: `game-designer`, `live-ops-designer`, `analytics-engineer`

package/templates/gamedev/faction-design.md

@@ -0,0 +1,166 @@
+# Faction Design: [Faction Name]
+
+*Created: [Date]*
+*Owner: world-builder*
+*Status: [Draft / Approved / Implemented]*
+
+---
+
+## Identity
+
+| Aspect | Detail |
+| ---- | ---- |
+| **Full Name** | [Official faction name] |
+| **Common Name** | [What people call them] |
+| **Type** | [Nation / Guild / Cult / Corporation / Tribe / etc.] |
+| **Alignment** | [Not D&D alignment — their moral complexity in 1 sentence] |
+| **Symbol** | [Description of their emblem/flag/sigil] |
+| **Colors** | [Primary and secondary colors associated with this faction] |
+| **Motto** | [Their defining phrase or creed] |
+
+---
+
+## Overview
+
+[2-3 paragraphs describing who this faction is, what they want, and why they
+matter to the game world. Write as if briefing someone who knows nothing.]
+
+---
+
+## History
+
+### Origin
+[How did this faction form? What event or need brought them together?]
+
+### Key Historical Events
+1. **[Event Name]** ([Date/Era]): [What happened and how it shaped the faction]
+2. **[Event Name]** ([Date/Era]): [Impact]
+3. **[Event Name]** ([Date/Era]): [Impact]
+
+### Current State
+[Where is this faction now? Are they ascendant, declining, stable, fractured?]
+
+---
+
+## Beliefs and Values
+
+### Core Beliefs
+- [Belief 1 — what they hold as fundamental truth]
+- [Belief 2]
+- [Belief 3]
+
+### What They Value
+- [Value 1 — what they reward and respect]
+- [Value 2]
+
+### What They Despise
+- [Thing 1 — what they punish or reject]
+- [Thing 2]
+
+---
+
+## Structure and Leadership
+
+### Hierarchy
+[How is the faction organized? Military ranks? Council of elders? Meritocracy?
+Describe the power structure.]
+
+### Key Figures
+| Name | Role | Personality | Motivation |
+| ---- | ---- | ---- | ---- |
+| [Leader] | [Title] | [2-3 adjectives] | [What drives them] |
+| [Second] | [Title] | [Personality] | [Motivation] |
+| [Notable] | [Title] | [Personality] | [Motivation] |
+
+### Membership
+- **How to join**: [Birth? Initiation? Purchase? Invitation?]
+- **How to leave**: [Can they? What happens?]
+- **Population**: [Rough size and composition]
+
+---
+
+## Territory and Resources
+
+### Holdings
+[Where does this faction control territory? What are their key locations?]
+
+### Resources
+- **Primary resource**: [What they have abundance of]
+- **Scarcity**: [What they lack and need]
+- **Trade goods**: [What they export/sell]
+
+### Military Strength
+[How powerful are they? Standing army? Special forces? Magical capabilities?
+Technology level?]
+
+---
+
+## Relationships
+
+| Faction | Relationship | Reason | Trend |
+| ---- | ---- | ---- | ---- |
+| [Faction A] | [Allied / Friendly / Neutral / Tense / Hostile / War] | [Why] | [Improving / Stable / Deteriorating] |
+| [Faction B] | [Relationship] | [Why] | [Trend] |
+| [Player] | [Starting disposition] | [Why] | [Player-influenced] |
+
+---
+
+## Reputation System (if applicable)
+
+| Tier | Points | Benefits | Requirements |
+| ---- | ---- | ---- | ---- |
+| Hostile | [-1000 to -500] | [Attacked on sight] | [Betrayal, war crimes] |
+| Unfriendly | [-500 to -100] | [No services, higher prices] | [Opposing actions] |
+| Neutral | [-100 to 100] | [Basic services] | [Default] |
+| Friendly | [100 to 500] | [Discounts, quests] | [Complete tasks] |
+| Honored | [500 to 1000] | [Unique items, areas, abilities] | [Major questline] |
+| Exalted | [1000+] | [Best rewards, title, housing] | [Full faction commitment] |
+
+---
+
+## Gameplay Role
+
+### Player Interaction
+[How does the player encounter and interact with this faction? Quests?
+Trading? Combat? Diplomacy?]
+
+### Unique Mechanics
+[Does this faction introduce any unique gameplay mechanics? Crafting recipes?
+Combat styles? Magic systems?]
+
+### Questlines
+[Brief overview of the major questlines associated with this faction.]
+
+---
+
+## Aesthetic Guide
+
+### Architecture
+[What do their buildings look like? Materials, shapes, scale.]
+
+### Clothing/Armor
+[What do members wear? Identifying visual elements.]
+
+### Technology/Magic Level
+[What tools, weapons, and abilities do they use?]
+
+### Audio Palette
+[What sounds are associated with this faction? Musical themes, ambient sounds.]
+
+---
+
+## Lore Consistency Notes
+
+- **Canon level**: [Core / Extended / Flavor — how important is this to the main story?]
+- **Contradictions to watch**: [Any potential conflicts with other lore]
+- **Open questions**: [Things not yet decided about this faction]
+- **Off-limits**: [Things that must NOT be true about this faction]
+
+---
+
+## Dependencies
+
+- Related factions: [List factions that interact with this one]
+- Related areas: [Levels/regions where this faction appears]
+- Related questlines: [Story arcs involving this faction]
+- Affects: [economy, combat encounters, narrative branches]

package/templates/gamedev/game-concept.md

@@ -0,0 +1,316 @@
+# Game Concept: [Working Title]
+
+*Created: [Date]*
+*Status: [Draft / Under Review / Approved]*
+
+---
+
+## Elevator Pitch
+
+> [1-2 sentences that capture the entire game. Should be compelling enough to
+> make someone want to hear more. Format: "It's a [genre] where you [core
+> action] in a [setting] to [goal]."
+>
+> Test: Can someone who has never heard of this game understand what they'd
+> be doing in 10 seconds? If not, simplify.]
+
+---
+
+## Core Identity
+
+| Aspect | Detail |
+| ---- | ---- |
+| **Genre** | [Primary genre + subgenre(s)] |
+| **Platform** | [PC / Console / Mobile / Cross-platform] |
+| **Target Audience** | [See Player Profile section below] |
+| **Player Count** | [Single-player / Co-op / Multiplayer / MMO] |
+| **Session Length** | [Typical play session: 10 min / 30 min / 1 hr / 2+ hr] |
+| **Monetization** | [Premium / F2P / Subscription / none yet] |
+| **Estimated Scope** | [Small (1-3 months) / Medium (3-9 months) / Large (9+ months)] |
+| **Comparable Titles** | [2-3 existing games in the same space] |
+
+---
+
+## Core Fantasy
+
+[What power, experience, or feeling does the player get from this game?
+What can they do here that they can't do anywhere else?
+
+The core fantasy is the emotional promise. It's not a feature list — it's the
+answer to "why would someone choose THIS game over anything else they could
+be doing?"
+
+Examples of strong core fantasies:
+- "You are a lone survivor building a new life in a hostile wilderness" (survival)
+- "You command a civilization across millennia" (strategy)
+- "You explore a vast, beautiful world at your own pace" (open world)
+- "You master intricate combat and overcome impossible odds" (soulslike)]
+
+---
+
+## Unique Hook
+
+[What makes this game different from everything else in its genre? This is
+the single most important differentiator.
+
+A strong hook passes the "and also" test: "It's like [comparable game],
+AND ALSO [unique thing]." If the "and also" doesn't spark curiosity, the
+hook needs work.
+
+The hook should be:
+- Explainable in one sentence
+- Genuinely novel (not just a combination of existing features)
+- Connected to the core fantasy (not a gimmick bolted on)
+- Something that affects gameplay, not just aesthetics]
+
+---
+
+## Player Experience Analysis (MDA Framework)
+
+The MDA (Mechanics-Dynamics-Aesthetics) framework ensures we design from the
+player's emotional experience backward to the systems that create it.
+
+### Target Aesthetics (What the player FEELS)
+Rank the following aesthetic goals for this game (1 = primary, mark N/A if not
+relevant). These come from the MDA framework's 8 aesthetic categories:
+
+| Aesthetic | Priority | How We Deliver It |
+| ---- | ---- | ---- |
+| **Sensation** (sensory pleasure) | [1-8 or N/A] | [Visual beauty, audio design, haptics] |
+| **Fantasy** (make-believe, role-playing) | [Priority] | [World, characters, player identity] |
+| **Narrative** (drama, story arc) | [Priority] | [Plot structure, player-driven stories] |
+| **Challenge** (obstacle course, mastery) | [Priority] | [Difficulty curve, skill ceiling] |
+| **Fellowship** (social connection) | [Priority] | [Co-op, guilds, shared experiences] |
+| **Discovery** (exploration, secrets) | [Priority] | [Hidden areas, emergent systems, lore] |
+| **Expression** (self-expression, creativity) | [Priority] | [Build variety, cosmetics, creation tools] |
+| **Submission** (relaxation, comfort zone) | [Priority] | [Low-stress loops, ambient gameplay] |
+
+### Key Dynamics (Emergent player behaviors)
+[What behaviors do we WANT to emerge from our mechanics? What should players
+naturally start doing without being told?
+
+Example: "Players will experiment with ability combinations to find synergies"
+Example: "Players will share discoveries with the community"]
+
+### Core Mechanics (Systems we build)
+[What are the 3-5 mechanical systems that generate the dynamics and aesthetics
+above? These are the rules, verbs, and systems we actually implement.]
+
+1. [Mechanic 1 — e.g., "Real-time combat with stamina management"]
+2. [Mechanic 2 — e.g., "Procedurally generated dungeons with hand-crafted rooms"]
+3. [Mechanic 3 — e.g., "Crafting system with discoverable recipes"]
+
+---
+
+## Player Motivation Profile
+
+Understanding WHY players play helps us make every design decision. Based on
+Self-Determination Theory (SDT) and the Player Experience of Need Satisfaction
+(PENS) model.
+
+### Primary Psychological Needs Served
+
+| Need | How This Game Satisfies It | Strength |
+| ---- | ---- | ---- |
+| **Autonomy** (freedom, meaningful choice) | [How does the player feel in control?] | [Core / Supporting / Minimal] |
+| **Competence** (mastery, skill growth) | [How does the player feel skilled?] | [Core / Supporting / Minimal] |
+| **Relatedness** (connection, belonging) | [How does the player feel connected?] | [Core / Supporting / Minimal] |
+
+### Player Type Appeal (Bartle Taxonomy)
+
+Which player types does this game primarily serve?
+
+- [ ] **Achievers** (goal completion, collection, progression) — How: [...]
+- [ ] **Explorers** (discovery, understanding systems, finding secrets) — How: [...]
+- [ ] **Socializers** (relationships, cooperation, community) — How: [...]
+- [ ] **Killers/Competitors** (domination, PvP, leaderboards) — How: [...]
+
+### Flow State Design
+
+Flow occurs when challenge matches skill. How does this game maintain flow?
+
+- **Onboarding curve**: [How do the first 10 minutes teach the player?]
+- **Difficulty scaling**: [How does challenge grow with player skill?]
+- **Feedback clarity**: [How does the player know they're improving?]
+- **Recovery from failure**: [How quickly can they try again? Is failure punishing or educational?]
+
+---
+
+## Core Loop
+
+### Moment-to-Moment (30 seconds)
+[What is the player physically doing most of the time? The most basic, repeated
+action. This MUST be intrinsically satisfying — if the 30-second loop isn't
+fun in isolation, no amount of progression will save the game.]
+
+### Short-Term (5-15 minutes)
+[What objective or cycle structures the moment-to-moment play? Encounters,
+puzzles, rounds, quests. This is where "one more turn" or "one more run"
+psychology lives.]
+
+### Session-Level (30-120 minutes)
+[What does a full play session look like? What does the player accomplish?
+This should end with a natural stopping point AND a reason to come back.]
+
+### Long-Term Progression
+[How does the player grow over days/weeks? Character progression, unlocks,
+story advancement, mastery. What is the player working toward?]
+
+### Retention Hooks
+[What specifically brings the player back for their next session?]
+- **Curiosity**: [Unanswered questions, unexplored areas, locked content]
+- **Investment**: [Progress they don't want to lose, characters they care about]
+- **Social**: [Friends playing, guild obligations, shared goals]
+- **Mastery**: [Skills to improve, challenges to overcome, rankings to climb]
+
+---
+
+## Game Pillars
+
+Design pillars are non-negotiable principles that guide EVERY decision. When
+two design choices conflict, pillars break the tie. Keep to 3-5 pillars.
+
+Real AAA examples:
+- God of War: "Intense combat", "Father-son story", "World exploration"
+- Hades: "Fast fluid combat", "Narrative depth through repeated runs"
+- The Last of Us: "Story as essential", "AI partners build relationships", "Stealth encouraged"
+
+### Pillar 1: [Name]
+[One sentence defining this non-negotiable design principle.]
+
+*Design test*: [A concrete decision this pillar would resolve. "If we're
+debating between X and Y, this pillar says we choose __."]
+
+### Pillar 2: [Name]
+[Definition]
+
+*Design test*: [Decision it resolves]
+
+### Pillar 3: [Name]
+[Definition]
+
+*Design test*: [Decision it resolves]
+
+### Anti-Pillars (What This Game Is NOT)
+
+Anti-pillars are equally important — they prevent scope creep and keep the
+vision focused. Every "no" protects the "yes."
+
+- **NOT [thing]**: [Why this is explicitly excluded and what it would compromise]
+- **NOT [thing]**: [Why]
+- **NOT [thing]**: [Why]
+
+---
+
+## Inspiration and References
+
+| Reference | What We Take From It | What We Do Differently | Why It Matters |
+| ---- | ---- | ---- | ---- |
+| [Game 1] | [Specific mechanic, feeling, or approach] | [Our twist] | [What it validates about our concept] |
+| [Game 2] | [What we learn] | [Our twist] | [Validation] |
+| [Game 3] | [What we learn] | [Our twist] | [Validation] |
+
+**Non-game inspirations**: [Films, books, music, art, real-world experiences
+that influence the tone, world, or feel. Great games often pull from outside
+the medium.]
+
+---
+
+## Target Player Profile
+
+[Be specific. "Gamers" is not a target audience.]
+
+| Attribute | Detail |
+| ---- | ---- |
+| **Age range** | [e.g., 18-35] |
+| **Gaming experience** | [Casual / Mid-core / Hardcore] |
+| **Time availability** | [e.g., "30-minute sessions on weeknights, longer on weekends"] |
+| **Platform preference** | [Where they play most] |
+| **Current games they play** | [2-3 specific titles] |
+| **What they're looking for** | [The unmet need this game fills] |
+| **What would turn them away** | [Dealbreakers for this audience] |
+
+---
+
+## Technical Considerations
+
+| Consideration | Assessment |
+| ---- | ---- |
+| **Recommended Engine** | [Unity / Unreal and why — consider scope, team expertise, platform targets] |
+| **Key Technical Challenges** | [What's technically hard about this game?] |
+| **Art Style** | [Pixel / 2D / 2.5D / 3D stylized / 3D realistic] |
+| **Art Pipeline Complexity** | [Low (asset store + modifications) / Medium (custom 2D) / High (custom 3D)] |
+| **Audio Needs** | [Minimal / Moderate / Music-heavy / Adaptive] |
+| **Networking** | [None / P2P / Client-Server / Dedicated Servers] |
+| **Content Volume** | [Estimate: X levels, Y items, Z hours of gameplay] |
+| **Procedural Systems** | [Any procedural generation? What scope?] |
+
+---
+
+## Risks and Open Questions
+
+### Design Risks
+[Things that could make the game unfun or uncompelling]
+- [Risk 1 — e.g., "Core loop may not sustain sessions > 30 minutes"]
+- [Risk 2 — e.g., "Player motivation unclear after main story ends"]
+
+### Technical Risks
+[Things that could be hard or impossible to build]
+- [Risk 1 — e.g., "Procedural generation quality is unproven"]
+- [Risk 2 — e.g., "Networking for 100+ players may require dedicated infrastructure"]
+
+### Market Risks
+[Things that could prevent commercial success]
+- [Risk 1 — e.g., "Genre is saturated with established competitors"]
+- [Risk 2 — e.g., "Target audience may be too niche for financial sustainability"]
+
+### Scope Risks
+[Things that could blow the timeline]
+- [Risk 1 — e.g., "Content volume exceeds team capacity"]
+- [Risk 2 — e.g., "Feature X depends on technology we haven't prototyped"]
+
+### Open Questions
+[Things that need prototyping or research before we can answer]
+- [Question 1 — and how we plan to answer it]
+- [Question 2 — and what prototype would resolve it]
+
+---
+
+## MVP Definition
+
+[The absolute minimum version that validates the core hypothesis. The MVP
+answers ONE question: "Is the core loop fun?"]
+
+**Core hypothesis**: [The single statement the MVP tests, e.g., "Players find
+the combat-crafting loop engaging for 30+ minute sessions"]
+
+**Required for MVP**:
+1. [Essential feature 1 — directly tests the hypothesis]
+2. [Essential feature 2]
+3. [Essential feature 3]
+
+**Explicitly NOT in MVP** (defer to later):
+- [Feature that's nice but doesn't test the hypothesis]
+- [Feature that adds scope without validating the core]
+
+### Scope Tiers (if budget/time shrinks)
+
+| Tier | Content | Features | Timeline |
+| ---- | ---- | ---- | ---- |
+| **MVP** | [Minimal] | [Core loop only] | [X weeks] |
+| **Vertical Slice** | [One complete area] | [Core + progression] | [X weeks] |
+| **Alpha** | [All areas, placeholder] | [All features, rough] | [X weeks] |
+| **Full Vision** | [Complete content] | [All features, polished] | [X weeks] |
+
+---
+
+## Next Steps
+
+- [ ] Get concept approval from creative-director
+- [ ] Fill in CLAUDE.md technology stack based on engine choice (`/setup-engine`)
+- [ ] Create game pillars document (`/design-review` to validate)
+- [ ] Decompose concept into systems (`/map-systems` — maps dependencies, assigns priorities, guides per-system GDD writing)
+- [ ] Create first architecture decision record (`/architecture-decision`)
+- [ ] Prototype core loop (`/prototype [core-mechanic]`)
+- [ ] Validate core loop with playtest (`/playtest-report`)
+- [ ] Plan first milestone (`/sprint-plan new`)