wordle/.claude/skills/gds-test-framework/checklist.md

Game Test Framework Setup - Validation Checklist

This checklist ensures the framework workflow completes successfully.

---

Prerequisites

• Game project exists with identifiable engine
• Engine type detected (Unity, Unreal, or Godot)
• No existing test framework conflicts
• Write permissions to create directories

---

Engine Detection

• Engine type correctly identified
• Engine version detected
• Project structure understood

---

Unity-Specific Checks

• Assets/Tests/ directory created
• EditMode/ subdirectory created with .asmdef
• PlayMode/ subdirectory created with .asmdef
• Assembly definitions reference game assembly
• UNITY_INCLUDE_TESTS constraint set
• Sample Edit Mode test created
• Sample Play Mode test created
• Tests compile without errors

---

Unreal-Specific Checks

• Source/<ProjectName>Tests/ directory created
• <ProjectName>Tests.Build.cs created
• Module references game module correctly
• Sample automation test created
• Test flags set correctly (ProductFilter)
• Tests compile without errors

---

Godot-Specific Checks

• GUT plugin installed in addons/gut/
• tests/ directory created
• tests/unit/ subdirectory created
• tests/integration/ subdirectory created
• gut_config.json created
• Sample test extends GutTest
• before_each/after_each patterns used
• Tests run without errors

---

Sample Tests

• Sample tests follow engine conventions
• Tests use Arrange-Act-Assert pattern
• Tests include proper cleanup
• Tests demonstrate framework capabilities
• Tests are syntactically correct

---

Documentation

• tests/README.md created
• Setup instructions included
• Running tests section included
• CI integration commands included
• Best practices section included

---

Quality Checks

• No compilation/syntax errors
• No placeholder text left
• No hardcoded paths (use engine conventions)
• Cleanup prevents orphan objects
• Tests are deterministic

---

Completion Criteria

• Engine correctly detected
• Directory structure created
• Configuration files generated
• Sample tests run successfully
• Documentation complete

---

Completed by: {name} Date: {date} Engine: {Unity | Unreal | Godot}