refactor(acp): move discovery into the operator

Author: onutc

OPENCLAW.md

@@ -6,6 +6,8 @@ This file is the single source of truth for OpenClaw-related behavior in this re
 
 Spritz supports running OpenClaw as a per-devbox application surface.
 Each devbox runs its own OpenClaw process and is opened through its own `/w/{name}` route.
+When OpenClaw is used as an ACP backend inside Spritz, it should also expose ACP on
+the reserved internal port `2529`.
 
 ## Where OpenClaw Lives in This Repo
 
@@ -37,6 +39,23 @@ The OpenClaw example entrypoint does the following:
 
 Key implication: direct `/w/{name}` access with `bind=lan` expects real gateway auth.
 
+## ACP Contract In Spritz
+
+Spritz treats ACP as backend-agnostic.
+
+For OpenClaw to appear in the Spritz ACP chat UI, the workspace must answer ACP on:
+
+- port `2529`
+- WebSocket path `/`
+
+Spritz will then:
+
+- discover the agent from the operator by sending ACP `initialize`
+- surface it in `status.acp`
+- proxy browser ACP traffic through `spritz-api`
+
+This ACP path is separate from OpenClaw's dashboard and gateway UI.
+
 ## Auth Modes and What to Use
 
 ### `token` (default-safe for current direct routing)

README.md

@@ -1 +1,24 @@
 # spritz
+
+Spritz is a Kubernetes-native control plane for ephemeral workspaces.
+
+## What it does
+
+- creates per-user or per-team workspace instances as `Spritz` resources
+- exposes web and terminal access through the Spritz API and UI
+- reserves ACP on port `2529` for agent-capable backends
+- automatically discovers ACP agents and exposes them in the built-in chat UI
+
+## Default runtime model
+
+- one Helm install
+- one public host for UI and API
+- workspace home starts at `/home/dev`
+- ACP is available on internal workspace port `2529`
+- browser ACP traffic always flows through `spritz-api`
+
+## Key docs
+
+- `/Users/onur/repos/spritz/docs/2026-02-24-simplest-spritz-deployment-spec.md`
+- `/Users/onur/repos/spritz/docs/2026-03-09-acp-port-and-agent-chat-architecture.md`
+- `/Users/onur/repos/spritz/OPENCLAW.md`