From 16f66f02de95a7295f432eb8c31fbbdb6a65a10e Mon Sep 17 00:00:00 2001
From: Admin_IT-one <admin_it-one@local.invalid>
Date: Fri, 21 Aug 2026 12:15:06 +0200
Subject: [PATCH] Add public shared-libs architecture guide

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

diff --git a/README.md b/README.md
index 72205b5..291e5d9 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,12 @@
 # shared-libs
 
-Shared libraries, UI kits, and common AI tools.
\ No newline at end of file
+Reusable libraries, UI kits, and common AI tools.
+
+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.