diff --git a/modules/party/README.md b/modules/party/README.md
index 4a2cc70..cc4b63e 100644
--- a/modules/party/README.md
+++ b/modules/party/README.md
@@ -1,3 +1,3 @@
 # party
 
-`party` registers compiled plugins and coordinates their framework-facing capabilities, translations, mail drivers, and metadata. The application runtime and framework services import it to discover plugins; start with `party.Registry` in `registry.go`.
+`party` registers compiled plugins and coordinates their framework-facing capabilities, translations, mail drivers, and metadata. Implement `party.Plugin`, call `party.Register` during plugin initialization, and use `party.Activate` to select and start registered plugins; these entry points live in `registry.go`.