diff --git a/README.md b/README.md
index d1ff6f8..d20abc1 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,6 @@
 # homepage
 
-Public homepage — Docker image deployed to homepage.ffaerber.duckdns.org
\ No newline at end of file
+Public homepage — Docker image deployed to homepage.ffaerber.duckdns.org
+
+How it ships itself — issue → agent team → PR → QA → autopilot merge → image → swarm deploy —
+is documented in [PIPELINE.md](PIPELINE.md).