From 365cf903d93efe2e6d9499c87db1d3331ebcb843 Mon Sep 17 00:00:00 2001
From: Admin_IT-one <admin_it-one@local.invalid>
Date: Fri, 21 Aug 2026 12:15:04 +0200
Subject: [PATCH] Add public core-platform architecture guide

---
 README.md | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

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.