diff --git a/README.md b/README.md
index a72766e..7fff985 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,3 @@
 # ci-scripts
 
-Shared Woodpecker CI templates and the CI scripts optimization epic
\ No newline at end of file
+Shared Woodpecker CI templates, plugins, and centralized pipeline conventions for the Oleks ecosystem. This repository hosts reusable CI components (clone steps, build templates, arch-specific runners) and tracks the cross-repo CI optimization effort to reduce duplication across ~50 projects in ~/projects.
\ No newline at end of file