| name | stack-standards |
| description | Repo-specific Godot 4.6 Android standards for Woman vs Horse VB, including free/open asset provenance and credits requirements. |
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 / free-open 2D asset pipeline
Core engineering rules
- Treat this repo as a Godot Android game with sourced free/open assets, not a generic framework-agnostic project.
- Use typed GDScript for gameplay scripts and keep scene/script changes aligned with the wave-combat loop from the canonical brief.
- Preserve the approved asset route: Kenney.nl, OpenGameArt.org, Freesound.org, and Google Fonts under the licensing rules already captured in repo-local skills.
- Any asset addition or replacement must keep
assets/PROVENANCE.md and CC-BY credit coverage truthful before the ticket can close.
- Prefer consistent imported asset packs over ad hoc one-off files that break style or provenance traceability.
Godot and asset-pipeline rules
- Script files stay
snake_case.gd; classes use PascalCase; constants use UPPER_SNAKE_CASE.
- Keep touch controls, wave logic, and UI flow compatible with the Android landscape target.
- Import only verified free/open assets. Reject non-commercial or unknown-license sources.
- If an asset is CC-BY, the credits scene must surface the attribution before closeout.
- Do not fabricate placeholder audio or art to satisfy acceptance; VB's finish contract requires real sourced assets with provenance.
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/womanvshorsevb-debug.apk
For asset tickets and remediation follow-up, also verify the exact imported files and provenance entries that changed. Do not treat expected provenance as completed provenance.
Review and QA expectations
- Review and QA must fail when the project does not load, the Android export fails, or imported assets are missing / broken.
- Review and QA must fail when any committed asset lacks a matching
assets/PROVENANCE.md entry.
- Remediation tickets with
finding_source must rerun the original failing command or check before approval.
- Reject fake PASS audio or review artifacts; explicit verdicts in review / QA output must match the actual command result.
Release-proof expectations
- The canonical release target is
build/android/womanvshorsevb-debug.apk.
- Final proof must include working touch controls, playable waves, and truthful sourced-asset presentation.
- Credits-scene and provenance correctness are part of finish quality, not optional documentation polish.
