diff --git a/packages/@addon-pay/client/README.md b/packages/@addon-pay/client/README.md
index 371d7c8..0cc01a1 100644
--- a/packages/@addon-pay/client/README.md
+++ b/packages/@addon-pay/client/README.md
@@ -1,3 +1,7 @@
 # @addon-pay/client
 
 Control-plane API client for configuring AddonPay. It will automate the same plans, entitlements, and service configuration that developers manage in the AddonPay dashboard.
+
+## Planned capabilities
+
+- Manage plans, entitlements, and service configuration through the AddonPay control-plane API.
diff --git a/packages/@addon-pay/sdk/README.md b/packages/@addon-pay/sdk/README.md
index 279de50..e773616 100644
--- a/packages/@addon-pay/sdk/README.md
+++ b/packages/@addon-pay/sdk/README.md
@@ -1,3 +1,7 @@
 # @addon-pay/sdk
 
 Client runtime SDK for AddonPay applications. It exposes the application-facing data needed to evaluate entitlements, inspect plans, and retrieve paywall configuration.
+
+## Planned capabilities
+
+- Read the entitlements, plans, and paywall configuration available to an application.