diff --git a/README.md b/README.md
index afbb2bd..572de2a 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,12 @@
 # core-platform
 
-DevOps, Kubernetes, inference hosting, and monitoring.
\ No newline at end of file
+DevOps, Kubernetes, LLM inference hosting (vLLM/Ollama), observability, and platform engineering.
+
+This public repository is a top-level area of the [IT-One](https://git.it-one.pro/IT-One) organization.
+
+## Collaboration
+
+- Use short-lived branches and pull requests.
+- Keep credentials out of Git; use organization-level Gitea Actions secrets.
+- Add a focused README to every project repository created in this area.
+- Use the [AI agent template](https://git.it-one.pro/IT-One/agent-template) for agent projects.