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.