git init

docs/development.md

@@ -0,0 +1,19 @@
+# Development
+
+Requirements: Rust 1.80+, Go 1.22+ (the container build uses 1.24), Node 22+,
+Docker with Compose v2, and PostgreSQL 16 for backend integration.
+
+```bash
+cargo test --manifest-path agent/Cargo.toml
+cd control-plane/backend && go test ./...
+cd ../frontend && npm ci && npm test -- --run && npm run build
+docker compose -f ../docker-compose.yml config
+```
+
+Copy example configuration; never commit live tokens. Parser tests use fixtures
+and ordinary suites must work on macOS/Linux without root. Host integration is a
+separate manual pass on a disposable supported VM.
+
+When adding an endpoint, update the agent route, control-plane proxy allow-list,
+RBAC policy, audit behavior (for writes), docs, and tests together. Prefer small
+dependencies and measure agent RSS before accepting runtime-heavy crates.