Add NIKO game concept document

design/gdd/game-concept.md

@@ -0,0 +1,310 @@
+# Game Concept: NIKO
+
+*Created: 2026-05-12*
+*Status: Draft*
+
+---
+
+## Elevator Pitch
+
+> A grieving tourist accidentally claims the supernatural artifact a criminal cartel invaded a paradise island to steal — and becomes the most dangerous thing on the island, hunting the man who took everything from him.
+
+---
+
+## Core Identity
+
+| Aspect | Detail |
+| ---- | ---- |
+| **Genre** | Action-Adventure / Supernatural Thriller |
+| **Platform** | PC (Steam / Epic Games Store) |
+| **Target Audience** | Story-driven action fans, 18–35, who love power fantasy with emotional weight |
+| **Player Count** | Single-player |
+| **Session Length** | 1–2 hours |
+| **Monetization** | Premium (one-time purchase) |
+| **Estimated Scope** | Large (12–18 months, solo developer) |
+| **Comparable Titles** | Control (2019), Psi-Ops: The Mindgate Conspiracy, Far Cry 1 |
+
+---
+
+## Story
+
+Niko and his wife Elena are vacationing on a remote tropical island. A criminal cartel — led by a man who has spent 25 years trying to recover an artifact stolen from his family — attacks and seizes control of the island. Civilians are taken prisoner. Elena is killed.
+
+Niko escapes into the jungle. While fleeing, he stumbles upon a hidden chamber and finds the box — the very artifact the cartel came to reclaim. It reacts to him. Power floods in.
+
+Now Niko moves through the occupied paradise with three supernatural abilities and one goal: reach the man responsible. But as he hunts through cartel compounds and discovers fragments of the box's 25-year history, he realizes the leader knows what the box can do far better than he does.
+
+**The central tension**: The leader came for the box because it's his family's. Niko has it. The more Niko uses it, the more the leader stops trying to capture him — and starts trying to destroy him.
+
+---
+
+## Core Fantasy
+
+You are the most dangerous thing on the island. The cartel arrived with soldiers, weapons, and a plan. Niko arrived with grief, and the one thing they came to get.
+
+Phase through walls. Pull weapons from soldiers' hands. Walk into a compound and turn their own men against them. Every power Niko gains is another piece of what the leader fears most. The fantasy is not just revenge — it's becoming something the cartel never planned for.
+
+---
+
+## Unique Hook
+
+Like *Far Cry 1*'s island atmosphere AND ALSO *Psi-Ops*'s physics-based power combat — with the twist that your enemy has spent 25 years researching exactly what your powers can do, and you're learning on the fly.
+
+---
+
+## Power Arc
+
+Each power unlocks at a story milestone. The unlocks are narrative turning points, not reward gates.
+
+| Act | Power Unlocked | Niko's State | What It Enables |
+| ---- | ---- | ---- | ---- |
+| **Act 1** | Telekinesis | Frightened, surviving | Throw objects, disarm guards, improvise |
+| **Act 2** | Phase through walls | Predatory, focused | Reposition through geometry, approach unseen |
+| **Act 3** | Remote mind control | Cold, transformed | Turn enemies against each other, reach the leader |
+| **Throughout** | Rage State | Grief-triggered | All powers amplify temporarily when emotionally triggered |
+
+**Rage State**: Activated when Niko encounters grief anchors — Elena's belongings, her voice on a recording, a prisoner who reminds him of her. Powers amplify for a short window. The state should feel dangerous, not just powerful — Niko losing control is part of the story.
+
+---
+
+## Player Experience Analysis (MDA Framework)
+
+### Target Aesthetics (What the player FEELS)
+
+| Aesthetic | Priority | How We Deliver It |
+| ---- | ---- | ---- |
+| **Fantasy** (power fantasy) | 1 | Three escalating supernatural abilities; Rage State; the cartel fearing Niko |
+| **Narrative** (revenge story) | 2 | Authored story, Elena's memory, cartel leader's personal history with the box |
+| **Discovery** (secrets, lore) | 3 | Fragments of the box's 25-year theft history found across the island |
+| **Sensation** (sensory pleasure) | 4 | Beautiful island environment, physics feedback, audio weight on powers |
+| **Challenge** (mastery) | 5 | Creative use of powers to clear encounters; Rage State risk |
+| **Expression** (player style) | 6 | Stealth vs. chaos vs. cinematic choices — same powers, different playstyles |
+| **Fellowship** | N/A | Single-player only |
+| **Submission** | N/A | Not a relaxation game |
+
+### Key Dynamics (Emergent player behaviors)
+
+- Players will experiment with chaining powers together (throw enemy → phase through wall → appear behind them)
+- Players will pause to explore the environment and read found documents about the box's history
+- Players will set up ambushes — using telekinesis to draw attention before phasing into position
+- Players will use Rage State strategically once they understand its trigger conditions
+- Players will emotionally engage with Niko's grief, not just his combat efficiency
+
+### Core Mechanics (Systems we build)
+
+1. **Telekinesis system** — grab, hold, throw, or suspend objects and enemies in real-time. Physics-based, weighted, satisfying.
+2. **Phasing system** — Niko becomes temporarily intangible, passing through walls and obstacles. Has a duration limit and a cooldown.
+3. **Mind control system** — remotely possess an enemy, control their actions, then release (leaving them disoriented or directing them to fight allies).
+4. **Rage State system** — triggered by environmental grief anchors. Amplifies all three powers. Duration tied to Niko's emotional state, not a UI bar.
+5. **Environmental reactivity** — the island responds to Niko's presence: patrols adapt, NPCs react, aftermath of encounters persists.
+
+---
+
+## Player Motivation Profile
+
+### Primary Psychological Needs Served
+
+| Need | How This Game Satisfies It | Strength |
+| ---- | ---- | ---- |
+| **Autonomy** | Player chooses stealth, chaos, or cinematic force. Powers create multiple valid solutions to every encounter. | Core |
+| **Competence** | Power unlocks mirror skill growth. Early encounters are survivable; late encounters feel mastered. The Rage State rewards emotional engagement. | Core |
+| **Relatedness** | Connection to Niko's grief for Elena. The prisoner NPCs create stakes. The cartel leader becomes a real antagonist with understandable motivation. | Supporting |
+
+### Player Type Appeal (Bartle Taxonomy)
+
+- [x] **Explorers** — discover the box's history, find hidden chambers, read fragments of the 25-year theft arc
+- [x] **Storytellers** — driven by Niko's revenge arc and the cartel leader's personal obsession
+- [x] **Achievers** — clear compounds, unlock all three powers, find all lore fragments
+- [ ] **Competitors** — not applicable (no PvP or leaderboards)
+
+### Flow State Design
+
+- **Onboarding curve**: Niko starts with telekinesis only. First encounter is one guard, one object to throw. The game teaches through doing, not tutorials.
+- **Difficulty scaling**: As powers unlock, encounter complexity increases. Early: 2-3 guards. Late: coordinated patrols requiring multi-power solutions.
+- **Feedback clarity**: Physics is the feedback. Enemies ragdoll, objects shatter, Rage State has a distinct visual and audio shift.
+- **Recovery from failure**: Quick reload, no long death sequences. Failure is educational — "try a different power combination."
+
+---
+
+## Core Loop
+
+### Moment-to-Moment (30 seconds)
+Observe an encounter space, identify threats and objects, use telekinesis (or later, phasing/mind control) to eliminate, disable, or redirect enemies. Physics feedback confirms success. Move forward.
+
+### Short-Term (5–15 minutes)
+Clear a compound or area section. Find a document, object, or scene that reveals a piece of the box's 25-year history or deepens Elena's memory. Trigger a Rage State or narrowly avoid triggering one.
+
+### Session-Level (30–120 minutes)
+Complete 1–2 story areas, progress Niko's power arc, uncover the next fragment of the box's history. Each session ends at a natural story beat — a revelation, a confrontation, or Niko finding something of Elena's.
+
+### Long-Term Progression
+Unlock all three powers across 4–6 hours of authored story. Piece together the full 25-year history of the box. Reach the cartel leader. The final confrontation forces Niko to use all three powers against someone who has studied them for decades.
+
+### Retention Hooks
+
+- **Curiosity**: Who stole the box 25 years ago, and why was it on this island? Each session reveals one more fragment.
+- **Investment**: Niko's grief is real. Players care about Elena without having played as her.
+- **Mastery**: As powers compound, players get better at chaining them creatively.
+
+---
+
+## Game Pillars
+
+### Pillar 1: Grief is the Engine
+Niko's pain is not backstory — it's the fuel. Every power surge, every Rage State, every quiet moment in the island's beauty is a reminder of Elena. The game never lets you forget why you're doing this.
+
+*Design test*: If we're debating between a cool combat mechanic and a story beat that deepens Niko's grief — we choose the story beat.
+
+### Pillar 2: You Are the Predator
+Niko should feel like the most dangerous thing on the island at all times — even when outnumbered. Powers create options, not overwhelm. Challenge comes from using them cleverly.
+
+*Design test*: If we're debating between adding more enemy pressure and giving the player a new way to use their powers — we give the player options.
+
+### Pillar 3: The Island Breathes
+The occupied paradise is a character. Beautiful, alive, corrupted. Players should stop and look. Environments react to Niko. The contrast between tropical scenery and cartel occupation is intentional and constant.
+
+*Design test*: If we're debating between a plain encounter space and an expressive, reactive environment — we build the environment.
+
+### Pillar 4: The Box Has a History
+The box is not a mystery for mystery's sake. The cartel leader's family owned it. Someone stole it 25 years ago. Niko discovers this history in fragments. The tension: the leader knows what the box can do — and Niko doesn't yet.
+
+*Design test*: If we're debating between keeping the box vague and revealing its history through gameplay — we reveal the history, but never the final truth of what the box *is*.
+
+### Anti-Pillars (What NIKO Is NOT)
+
+- **NOT multiplayer or open-world grinding**: This is a focused, authored revenge story. Every minute earns its place.
+- **NOT a full explanation of the box**: The history of the theft unfolds through discovery. The ultimate nature of the box stays ambiguous.
+- **NOT power fantasy without cost**: The Rage State feels dangerous, not just fun. Niko losing control is part of the story.
+
+---
+
+## Visual Identity Anchor
+
+**Direction**: Occupied Paradise
+
+The island is still beautiful — lush, sun-drenched, alive with color. That's the point. The horror of occupation is visible *against* that beauty, not instead of it. Burned-out vehicles half-buried in sand. Cartel checkpoints framed by palm trees. A prisoner cage with an ocean view.
+
+**Visual rule**: Every environment should be somewhere you'd want to visit — and somewhere you wouldn't want to be right now.
+
+**Supporting principles**:
+- High contrast between natural beauty and military presence — never grey-on-grey.
+- Niko's powers have a distinct visual signature — objects under telekinesis glow faintly; phasing makes Niko translucent; mind-controlled enemies show a subtle eye effect.
+- The Rage State desaturates the environment briefly, isolating color to Niko's hands and eyes.
+
+**Color philosophy**: Warm tropical palette (gold, turquoise, green) for the island. Cold steel and khaki for cartel infrastructure. Niko's power signature uses a deep amber — the color of the box.
+
+---
+
+## Inspiration and References
+
+| Reference | What We Take From It | What We Do Differently | Why It Matters |
+| ---- | ---- | ---- | ---- |
+| Far Cry 1 | Island atmosphere, tropical beauty, occupation tension, environmental storytelling | Supernatural powers replace gunplay as the primary verb; authored story vs. open world | Validates the island-as-setting and the "paradise corrupted" visual contrast |
+| Psi-Ops: The Mindgate Conspiracy | Physics-based telekinesis, the visceral satisfaction of throwing enemies | Narrative weight behind every power; grief as the fuel, not military duty | Proves the telekinesis core loop can be intrinsically fun |
+| God of War (2018) | Grief-driven protagonist, rage mechanics, transformation arc, weighty combat | Powers replace physical combat as the primary expression; smaller, tighter scope | Validates that player empathy with a grieving protagonist can anchor an action game |
+
+**Non-game inspirations**:
+- *Oldboy* — a man with one goal, hunting methodically through escalating opposition
+- *The Machinist* — guilt and grief as a physical presence
+- The visual language of tropical island photography — sunsets that make violence feel surreal
+
+---
+
+## Target Player Profile
+
+| Attribute | Detail |
+| ---- | ---- |
+| **Age range** | 18–35 |
+| **Gaming experience** | Mid-core — comfortable with 3D action games, not looking for Souls-level difficulty |
+| **Time availability** | 1–2 hour sessions, evenings and weekends. Will finish a 4–6 hour game in 3–5 sessions. |
+| **Platform preference** | PC |
+| **Current games they play** | Control, Dishonored, God of War (PC port), Psi-Ops (nostalgic) |
+| **What they're looking for** | A focused, cinematic story with a power fantasy that feels earned, not given |
+| **What would turn them away** | Grinding, excessive open-world padding, unclear story motivation, janky physics |
+
+---
+
+## Technical Considerations
+
+| Consideration | Assessment |
+| ---- | ---- |
+| **Recommended Engine** | TBD — run `/setup-engine` to determine based on physics requirements, 3D scope, and solo-dev constraints |
+| **Key Technical Challenges** | Physics-based telekinesis (object interaction, ragdolls); phasing geometry collision; mind control AI; environmental reactivity |
+| **Art Style** | 3D realistic with stylized lighting — tropical color palette, high environmental contrast |
+| **Art Pipeline Complexity** | High — custom 3D environments, character models, power VFX, ragdoll physics |
+| **Audio Needs** | High — powers need distinct audio signatures; music should shift with emotional state; ambient island sound is a character |
+| **Networking** | None |
+| **Content Volume** | 5–7 encounter areas, 3 power systems, 1 Rage State system, 15–20 lore fragments, 4–6 hours gameplay |
+| **Procedural Systems** | None — fully authored environments and encounters |
+
+---
+
+## Risks and Open Questions
+
+### Design Risks
+- The 30-second loop (telekinesis only, Act 1) must be fun in isolation — if throwing things isn't satisfying before phasing and mind control arrive, nothing downstream saves it.
+- Mind control requires enemies complex enough to be interesting to control — underestimating the AI requirements here is the most likely design failure.
+- The Rage State must feel different from normal play — if it's just a damage buff, it loses its narrative weight.
+
+### Technical Risks
+- Physics-based powers in 3D are the hardest possible first-game technical challenge. The MVP exists specifically to test whether this is buildable.
+- Phasing through geometry requires careful collision and camera management — common source of bugs.
+- Mind control AI (controlling enemy movement, making it feel deliberate and useful) is non-trivial.
+
+### Market Risks
+- The "supernatural powers in a contained world" space is proven but competitive (Control, Dishonored). Differentiation must come from the emotional story, not just the powers.
+- 4–6 hours is short — the game must justify its price point with quality, not length.
+
+### Scope Risks
+- First game + 3D + physics powers = very high complexity. Scope discipline is critical. The MVP must prove viability before any expansion.
+- Art pipeline (custom 3D environments + characters + VFX) is the largest time cost for a solo developer.
+
+### Open Questions
+- Which engine can handle the physics requirements within a solo-dev workflow? → Resolved by `/setup-engine`
+- Is telekinesis fun in isolation before other powers arrive? → Resolved by MVP prototype
+- Can mind control be implemented with satisfying AI in a 6–12 month timeline? → Resolved by `/prototype mind-control`
+
+---
+
+## MVP Definition
+
+**Core hypothesis**: Throwing enemies and objects in a reactive 3D environment is intrinsically satisfying — players will want to keep doing it.
+
+**Required for MVP**:
+1. One island encounter area (beachside cartel camp)
+2. Telekinesis — grab, hold, throw objects and enemies
+3. 4–5 enemies with basic patrol AI
+4. One environmental story beat (Niko finding something of Elena's)
+5. Physics feedback: ragdolls, object destruction, audio on impact
+
+**Explicitly NOT in MVP** (defer to later):
+- Phasing and mind control
+- Rage State
+- Full island traversal
+- Story cutscenes or voice acting
+- Lore fragments and the box's history
+
+### Scope Tiers
+
+| Tier | Content | Features | Timeline |
+| ---- | ---- | ---- | ---- |
+| **MVP** | 1 encounter area | Telekinesis only, basic patrol AI | 4–8 weeks |
+| **Vertical Slice** | 2 areas (beach + jungle compound) | Telekinesis + Phasing, story framework, 2 lore fragments | 3–4 months |
+| **Alpha** | All 5–7 areas (rough) | All 3 powers + Rage State, placeholder cutscenes, full lore trail | 8–10 months |
+| **Full Vision** | Complete 4–6 hour story | All features polished, final audio, complete cartel leader arc | 12–18 months |
+
+---
+
+## Next Steps
+
+Pre-production pipeline (in order):
+
+1. - [ ] Run `/setup-engine` — determine engine based on physics requirements and solo-dev constraints
+2. - [ ] Run `/art-bible` — establish visual identity before any asset production begins
+3. - [ ] Run `/design-review design/gdd/game-concept.md` — validate concept completeness
+4. - [ ] Run `/map-systems` — decompose concept into individual systems with dependencies
+5. - [ ] Run `/design-system [telekinesis]` — author the core power system GDD first
+6. - [ ] Run `/create-architecture` — produce the master architecture blueprint
+7. - [ ] Run `/prototype telekinesis` — validate the core loop before committing to full scope
+8. - [ ] Run `/playtest-report` — validate the core hypothesis after prototype
+9. - [ ] Run `/sprint-plan new` — plan the first development sprint