Files
Neutron/AGENTS.md
T

3.0 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 is selected by source scripts/env.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 mode is evidence-led architecture continuation. The initial checkpoint is documented in docs/checkpoint/review.md. Pause feature expansion; use the playable 69d0187 baseline as a comparison tool. Read docs/checkpoint/README.md, coverage.md and implementation-plan.md before gameplay changes. Only evidence probes or directly evidenced corrections belong in this checkpoint; distinguish static recovery, port tests and original runtime evidence.

Local REA/Ghidra is available through scripts/rea.sh; see docs/rea.md for the ignored launcher environment and JDK paths. Existing client MCP registration was not changed. Use generated copies, preserve complete Evidence/snapshots, and keep static decompilation distinct from source execution. Current C3 continuation: docs/checkpoint/control-phase-implementation.md; remaining body/wrapper/camera gates are in its final section and the implementation ledger.