stack-standards

name	stack-standards
description	Repo-specific Godot 4.6 Android standards for Woman vs Horse VD, including zero-import Godot-native art and procedural SFX rules.

Stack Standards

Before applying these rules, call skill_ping with skill_id: "stack-standards" and scope: "project".

Current stack: Godot 4.6 / GDScript / Android export / Godot-native zero-import visuals

Core engineering rules

• Treat this repo as a Godot Android technical-showcase game built entirely from native engine features, not a generic framework-agnostic project.
• Use typed GDScript for gameplay and effect controllers, and keep the top-down arena combat loop aligned with the canonical brief.
• Preserve the zero-import contract: visuals, UI, and audio come from Godot nodes, shaders, particles, themes, and procedural audio only.
• Prefer reusable Godot-native scene components over introducing imported files or off-repo tools.
• Keep mobile performance in mind when adding shaders, particles, or layered effects.

Godot-native art rules

• Script files stay snake_case.gd; classes use PascalCase; constants use UPPER_SNAKE_CASE.
• Use Polygon2D, TileMap, ShaderMaterial, GPUParticles2D, Line2D, Theme, and AudioStreamGenerator as the primary finish surfaces.
• Any imported .png, .wav, .ogg, .glb, or Blender-authored asset is a contract break unless the canonical brief changes first.
• Keep shaders compatible with mobile rendering targets and reject desktop-only assumptions.
• Silence is an acceptable fallback for audio only when the active ticket explicitly allows it; do not fake completion with broken generated audio.

Validation commands

Run the narrowest commands that prove the active ticket honestly passes:

• Project load / import check: godot4 --headless --path . --quit
• Android export proof: godot4 --headless --path . --export-debug "Android Debug" build/android/womanvshorsevd-debug.apk

For native-art tickets, also verify that the finished result still uses built-in Godot features only. Do not substitute imported assets just because a command passed.

Review and QA expectations

• Review and QA must fail when the project does not load, shaders fail, particles or native scene resources break, or the Android export fails.
• Review and QA must fail when imported external assets appear in a repo that is supposed to remain zero-import.
• Remediation tickets with finding_source must rerun the original failing command before approval.
• Reject placeholder-only visuals if they do not satisfy the Godot-native finish contract described in the brief.

Release-proof expectations

• The canonical release target is build/android/womanvshorsevd-debug.apk.
• Final proof must show Android export success plus working native-art effects, touch controls, and playable combat.
• The absence of external assets is part of the product contract and must stay true through closeout.