docs

docs/AGENT_ARCHITECTURE.md

@@ -0,0 +1,27 @@
+# GSP Windows Agent Architecture
+
+Workspace reference: [`GSP-WORKSPACE.md`](../../GSP-WORKSPACE.md)
+
+This repository owns the Windows execution engine for GSP.
+
+## Responsibilities
+
+- expose the same agent RPC surface as the Linux agent
+- launch and monitor customer game servers on Windows
+- manage lifecycle operations using Cygwin-compatible tooling
+- execute panel-approved commands and scripts
+- return logs, status, and command results
+
+## Primary runtime pieces
+
+| Path | Purpose |
+| --- | --- |
+| `OGP64/bin/` | Cygwin runtime binaries |
+| `OGP64/OGP/ogp_agent.pl` | Core OGP Perl agent |
+| `OGP64/agent_start.bat` | Manual startup launcher |
+| `OGP64/agent_stop.bat` | Manual shutdown launcher |
+| `OGP64/OGP/Cfg/` | Runtime configuration and templates |
+
+## Design rule
+
+Keep the Windows agent behavior as close to Linux as possible, but isolate unavoidable platform differences in the Windows layer.