From 24a72f468d668952dd19030c254092ff8c142ec2 Mon Sep 17 00:00:00 2001
From: REDCODE <aironenerowork@gmail.com>
Date: Sun, 14 Jun 2026 00:42:49 +0200
Subject: [PATCH] Agents.md (kinda overdue at this point)

---
 AGENTS.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..35e115a
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,46 @@
+# AGENTS.md — SlaveMatrixDecomp
+
+## Project
+
+Decompilation + modding re-architecture of "Slave Matrix" (Auto Eden). Three .NET 8 projects:
+- **SlaveMatrix** (`WinExe`) — game entrypoint `SlaveMatrix.Program.Main` at `SlaveMatrix/SlaveMatrix/GameClasses/Program.cs`
+- **2DGAMELIB** (class library) — legacy rendering engine (GDI+) + core data types (BodyTemplate, ShapePart, etc.)
+- **SlaveMatrix.Extract** (`Exe`) — asset pipeline CLI; depends on SlaveMatrix for embedded resources
+
+## Build & Run
+
+```
+dotnet build Solution.sln          # build all
+./run.sh                            # launch game (cds to game_folder/, sets DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1)
+dotnet run --project SlaveMatrix.Extract -- --output <path>   # asset extraction
+```
+
+The game **must** run with `game_folder/` as working directory. `launchSettings.json` sets this automatically in VS/Rider.
+
+## Key Quirks
+
+- **C# 9.0** (`LangVersion` hardcoded in `.csproj`). No `ImplicitUsings` in SlaveMatrix/2DGAMELIB.
+- **x64 only**, `AllowUnsafeBlocks=true`, `InvariantGlobalization=true` (needed on Linux).
+- **BinaryFormatter** still in use (legacy saves). Requires `EnableUnsafeBinaryFormatterSerialization=true` and `NoWarn=SYSLIB0011`.
+- **`System.Drawing.EnableUnixSupport`** must be set at startup (`runtimeconfig.template.json` + `AppContext.SetSwitch` in `Program.cs`).
+- **Newtonsoft.Json** (not `System.Text.Json`) — used in 2DGAMELIB and Extract.
+- **Empty `RootNamespace`** in SlaveMatrix and 2DGAMELIB — types live in global namespace.
+- **`GenerateAssemblyInfo=false`** — uses legacy `Properties/AssemblyInfo.cs`.
+- **No test projects**, no CI/CD, no formatter/linter config.
+- **843 BodyPartClasses** (`SlaveMatrix/SlaveMatrix/BodyPartClasses/`). **Do not rename** — C# reflection (`Type.GetType`) resolves joint types by class name at runtime.
+
+## Architecture Notes
+
+- **BodyTemplate** (13 binary `Obj` resources) → `VariantGrid` → `MorphVariant` → `PartGroup` → `ShapePart` tree with cardinal-spline curves and joint points. Deserialized via `BinaryFormatter` + `RemappedTypeBinder` (type remapping for decompiled names).
+- **Extract pipeline** (`SlaveMatrix.Extract`) loads the 13 embedded resources, applies `MigrateKeys()` (23-entry runtime KeyMap for Japanese→English), then exports:
+  - Intermediate JSON → `extracted/` (gitignored)
+  - SVG + YAML per part → `SlaveMatrix/Assets/Parts/` (checked in)
+  - `Catalog.yaml` index → `SlaveMatrix/Assets/`
+- **EnglishNameMap** in `SlaveMatrix.Extract/Program.cs` (179 entries) is for extraction output naming only. It is separate from the smaller runtime `MigrateKeys` KeyMap which only covers keys the old game code actually looks up.
+- **Phase 0 (extraction) is complete.** Phases 1-5 (engine rewrite) are planned in `PLAN.md`.
+
+## Git
+
+- `.gitignore` excludes: `**/bin/`, `**/obj/`, `.vs/`, `.idea/`, `Config.ini`, `game_folder/save/*`, `extracted/`.
+- `SlaveMatrix/Assets/` (auto-generated SVGs + YAML) **is** checked in.
+- `game_folder/` runtime assets are checked in (bgm, text, etc.).