diff --git a/plugins/linkedin-studio/README.md b/plugins/linkedin-studio/README.md
index d220705..2d07cc1 100644
--- a/plugins/linkedin-studio/README.md
+++ b/plugins/linkedin-studio/README.md
@@ -424,6 +424,29 @@ Agents that consume analytics data: `analytics-interpreter` (interpret/report mo
 
 ---
 
+## Boundaries (as of 2026-05)
+
+LinkedIn Studio is honest about what it can and cannot do for a **personal
+profile**. As of 2026-05:
+
+- **Post-level analytics via API** — exists, but is **partner-gated** (a vetted
+  Community Management API app + a verified organization + a Page). It is **not
+  self-serve** for a solo personal profile, so the practical floor is the **CSV
+  export** you drop into `/linkedin:import`. Per-post **saves** are visible in your
+  **native** LinkedIn post analytics (count-only, since ~Sept 2025), but there is
+  no self-serve API to pull them — this tool does not auto-track them; read them in
+  LinkedIn directly.
+- **Auto-publish** — technically **possible** self-serve via the `w_member_social`
+  scope, so this is **not** an API limitation. LinkedIn Studio **deliberately does
+  not** post for you: the OAuth/token overhead plus LinkedIn's terms on automated
+  posting make copy-to-clipboard + you-paste the right default. This is a **design
+  choice**, not an impossibility. The calendar's "publish" action marks a post
+  **you** posted as published — it never posts on your behalf.
+- **Dwell time** — internal to LinkedIn for organic posts; not exportable. The tool
+  does not measure it.
+
+---
+
 ## Personalization Engine
 
 The plugin tracks how well you've populated asset templates with your own data. A higher personalization score means more tailored content output.
diff --git a/plugins/linkedin-studio/commands/calendar.md b/plugins/linkedin-studio/commands/calendar.md
index 398a782..42885f2 100644
--- a/plugins/linkedin-studio/commands/calendar.md
+++ b/plugins/linkedin-studio/commands/calendar.md
@@ -87,7 +87,9 @@ Use AskUserQuestion:
 
 ### Action: Mark as Published
 
-This is the publish flow (no separate command — runs inline here).
+This is the publish flow (no separate command — runs inline here). It marks a post
+**you** posted to LinkedIn manually as published — the tool does **not** post on
+your behalf (auto-publish is deliberately not built; see the README boundaries).
 
 **3a. Show publishable posts.** Present today's scheduled posts and any overdue posts:
 
diff --git a/plugins/linkedin-studio/commands/import.md b/plugins/linkedin-studio/commands/import.md
index 73c0034..7ab00c8 100644
--- a/plugins/linkedin-studio/commands/import.md
+++ b/plugins/linkedin-studio/commands/import.md
@@ -23,6 +23,12 @@ You are a LinkedIn analytics data import assistant. Guide the user through impor
 
 For data format details and directory structure, see `assets/analytics/README.md`.
 
+> **Why CSV (as of 2026-05).** Post-level analytics via LinkedIn's API is
+> partner-gated (vetted Community Management app + verified org + Page) and **not
+> self-serve** for a personal profile, so the CSV export is the practical floor.
+> Saves are visible in native post analytics (count-only) but have no self-serve
+> API pull; dwell is internal-only for organic posts. See the README boundaries.
+
 ## Step 1: Check for CSV Files in Exports Directory
 
 First, check if any CSV files exist in the exports directory:
diff --git a/plugins/linkedin-studio/commands/report.md b/plugins/linkedin-studio/commands/report.md
index bba28d7..61966cf 100644
--- a/plugins/linkedin-studio/commands/report.md
+++ b/plugins/linkedin-studio/commands/report.md
@@ -236,7 +236,7 @@ Compare current week's `aggregateMetrics` against baseline means and standard de
 🔴 **Critical: Engagement rate declining**
 Your engagement rate has dropped from 4.2% to 2.8% over the last 3 weeks.
 → **Action:** Review recent post hooks. Consider more provocative angles or questions.
-→ **Reference:** Hook length should be <140 chars. In the engagement order (see `references/algorithm-signals-reference.md`), saves rank above shares, then quality comments, then reactions. Saves are visible in your native LinkedIn post analytics (count-only, ~Sept 2025 onward) but there is no self-serve API to pull them — so this tool does not auto-track saves; read them in LinkedIn directly. Dwell time is internal to LinkedIn for organic posts (not exposed anywhere this tool can read).
+→ **Reference:** Hook length should be <140 chars. In the engagement order (see `references/algorithm-signals-reference.md`), saves rank above shares, then quality comments, then reactions. Saves are visible in your native LinkedIn post analytics (count-only, ~Sept 2025 onward) but (as of 2026-05) there is no self-serve API to pull them — so this tool does not auto-track saves; read them in LinkedIn directly. Dwell time is internal to LinkedIn for organic posts (not exposed anywhere this tool can read).
 
 🟢 **Positive: New impression record**
 Your post on [topic] achieved 12,500 impressions — a personal best!