Imported from kvu787/ZoomTracks (
AGENTS.md). Install upstream withnpx skills add kvu787/ZoomTracks. Copyright stays with the author.
Base template
External tools
You may use the tools in %UserProfile%\Program.
You may refer to local copies of source repos in %UserProfile%\Repository\External.
Godot
If you create a Godot project, include a "Run.cmd" file that builds and launches the standalone exe of the Godot project by double-clicking the Run.cmd from File Explorer.
Git
When implementing stuff, avoid difficult-to-review "mega-commits". Split large work into multiple commits to make it easier to review. Separate commits that record conversations from other commits.
Markdown tables
Tables in Markdown must be padded and aligned in a way to make them easy to read in a plaintext editor, not only in a Markdown viewer.
Mathematical notation in Markdown
Any mathematical notation in Markdown files (LaTeX, KaTeX, MathJax, etc) must display properly in VSCode's Markdown previewer, GitHub.com's Markdown displayer, and the markdown viewer in the Windows 11 ChatGPT app.
Base template additions
Compatibility
Do not attempt to maintain any sort of application compatibility between different commits of the repo. This creates unwanted complexity.
Repository-specific
Info
- The Unity Engine game project is located in the ZoomTracks subfolder.
- Game logs are in
ZoomTracks\MyLogOutput.
TrackBuilder tests
Testing architecture and commands are documented in
Blender\TrackBuilder\Documentation\TEST.md.
TrackBuilder test inputs in Blender\TrackBuilder\TestInputs are committed and
must contain TrackBuilder/Input/Outlines without a generated
TrackBuilder/Output. Regenerate and commit them only after a deliberate
test-fixture change:
& "$env:USERPROFILE\Program\blender-4.5.12-windows-x64\blender.exe" --background --factory-startup --python-exit-code 1 --python "Blender\TrackBuilder\GenerateTrackBuilderSamples.py"
After any change that can affect TrackBuilder output, validation, fixtures, or
tests, run Blender\TrackBuilder\TestTrackBuilder.py. Each run writes inspectable
.blend results and an overall report to the gitignored
Blender\TrackBuilder\TestArtifacts directory. Never commit those artifacts.