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