2.3 KiB
Neutron GamePort
Follow ../AGENTS.md and ../prompt.MD. This is the local Git repository.
Do not configure a remote, push, upload originals or use cloud CI.
Originals are in ../Original/ and must remain byte-identical; verify using
python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json.
Use .NET 10, Silk.NET.Vulkan Vulkan 1.3+, SDL3 and shared Linux/Windows x64 code. Keep recovered data/algorithms distinct from unverified approximations. Require runtime evidence before claiming working gameplay or platform compatibility.
Working map
src/GamePort/: runtime, platform, rendering, assets and game systems.tools/: Python analysis/extraction tools (stdlib where practical).tests/: original-data regressions and bounded parser tests.scripts/: local dependency, build, test and packaging entry points.docs/: durable evidence and continuation notes..tools/,.nuget/,artifacts/,dist/: ignored local generated data.
Build from this directory with dotnet build, dotnet run; project-local SDK
may require scripts/dotnet.sh (consult README for verified invocation).
Python tests: python3 -m unittest discover -s tests -v.
Local builds: scripts/build-linux.sh, scripts/build-windows.sh;
tests: scripts/test.sh; packages: scripts/package.sh.
Coordination
Native subagents supported, max three investigators alongside primary. Explicit
exclusive file ownership; primary reviews, integrates, tests and commits milestones.
Binary agent: tools/binary/, binary/graphics analysis. Asset agent: extractors,
asset/format docs, extractor tests. Infrastructure agent: runtime/build scripts and
infrastructure report. Primary: GAM loader, gameplay/recon/docs and integration.
Coordinate any ownership transfer before editing shared files. No agent commits
other agents' active changes. Keep updates concise, save detailed evidence to disk.
Use bounded endian-aware parsers, portable paths, clear C#, deterministic tests,
and explicit unmanaged ownership. Build frequently. Update docs/progress.md,
docs/tasks.md, docs/decisions.md, and compatibility evidence before transitions.
Current priority is exact asset recovery and one reconstructed original scene;
read those documents for actual completion status and next actions.