worshop work

docs/ARCHITECTURE.md

@@ -0,0 +1,45 @@
+# GSP Architecture Overview
+
+Workspace reference: [`GSP-WORKSPACE.md`](../../GSP-WORKSPACE.md)
+
+This repository is the control plane for the GSP ecosystem. It owns the Panel, the Website, shared documentation, and the modules that decide what actions should be taken for each hosted server.
+
+## How to read this repo
+
+Start here:
+
+1. `README.md`
+2. `docs/ARCHITECTURE.md`
+3. `docs/PANEL_ARCHITECTURE.md`
+4. `docs/AGENT_COMMUNICATION.md`
+5. `docs/REPOSITORY_STRUCTURE.md`
+6. `docs/COMMAND_FLOW.md`
+7. `docs/UPDATE_POLICY.md`
+
+Then use the deeper docs under `docs/architecture/`, `docs/features/`, `docs/modules/`, and `docs/development/` for implementation details.
+
+## System boundary
+
+GSP owns:
+
+- user and admin-facing web UI
+- server lifecycle orchestration
+- module routing and shared state
+- XML/configuration authoring
+- update policy and backup policy
+- documentation for the full ecosystem
+
+GSP does not own the OS-level execution engine. That responsibility belongs to the Linux and Windows agent repositories.
+
+## Canonical runtime model
+
+User action
+→ Panel module
+→ remote command generation
+→ agent communication
+→ Linux or Windows agent
+→ OGP Perl agent
+→ operating system
+→ hosted game server
+
+The Panel is authoritative for business logic. Agents should execute requests and report results.