References & Planning Documents

All project planning artifacts, design specifications, and external resource links.

Planning Documents

Document Category Description
Unified PRD — Wave Survival PRD Approved planning baseline. Product vision, experience pillars, scope, spawn algorithm, combat design, HUD spec, map requirements.
Game Design Document GDD Core architecture — maps, domain model, entity relationships, UI framework, and remaining work checklist.
Expert Critique Review Architecture review — coupling risks, tooling priorities, test strategy, and mitigation recommendations.
Vertical Slice Roadmap Roadmap Slices 0-3 dependency map, scope definitions, go/no-go gates, and risk mitigations.
MVP Status Report Status Cycle 1 build report — what was built, controls, known issues, and Cycle 2 priorities.
Agent Swarm Handoff Handoff Expert deliverables — architecture validation, tooling, slice sequencing, external expert packet, menu direction.
Swarm Build Handoff Prompt Prompt Copy/paste prompt for running a planning+alignment swarm before implementation.
Game Design Expert Handoff Handoff Pre-production expert pass — confirmed findings baseline, asset constraints, licensing obligations.
External Expert Prompt Prompt Polished prompt for soliciting external game design review with structured response format.
Menu Direction Brief Brief Locked menu UX direction — visual style, navigation model, accessibility, persistence.
Map Mockups Design Spec Design Technical specification backing the wave map mockups — texture legend, gameplay flow, vertical layers.
Cycle 2 Handoff Handoff Cycle 2 implementation instructions — audio download, map expansion, bug fixes.
Cycle 3 Handoff Handoff Cycle 3 scope — power-ups, additional maps, polish.
Cycle 4 Handoff Handoff Cycle 4 scope — final polish, web export, deployment prep.
Site Handoff Handoff Link audit, repo structure, known limitations, next steps for dev.gankmid.co.

Design Documents (In This Site)

Document Type Description
3D Asset Gallery Interactive Rotatable 3D models for all characters, skeletons, weapons. Full animation library with click-to-preview.
Audio Asset Gallery Interactive Embedded Freesound players for all 24 audio assets. Bus layout diagram, trigger wiring table, options menu mockup.
Menu & HUD Mockups Interactive Main menu, pause menu, options with draggable sliders, HUD with health/stamina/timer.
Wave Map Mockups Interactive SVG floor plans and vertical cross-sections for maps A (1 entrance), B (2), and C (3).
Audio Design Spec Spec Full audio specification with bus layout, trigger wiring, AudioManager API, settings persistence.
Power-Up Design Spec Spec Three power-ups with drop mechanics, buff tracking, HUD integration, player script changes.

External Asset Sources

Asset Source License
KayKit Adventurers 2.0 itch.io CC0
KayKit Skeletons 1.1 itch.io · GitHub CC0
KayKit Character Animations 1.1 itch.io CC0
Kenney Prototype Textures kenney.nl · itch.io CC0
Monogram Font itch.io CC0
PS4 Buttons — Premium Assets itch.io CC-BY 4.0 (attribution required)
Freesound Audio Assets (24 sounds) freesound.org CC0 (20) / CC-BY 4.0 (4)

Technology

ToolVersionPurpose
Godot Engine4.6Game engine — Forward+ renderer, GDScript
GDScript4.xPrimary scripting language
model-viewer4.03D model previews in design docs (web component)