diff --git a/frontend/packages/dashboard/src/dashboard.html b/frontend/packages/dashboard/src/dashboard.html
index 91e38517..c2ef6f35 100644
--- a/frontend/packages/dashboard/src/dashboard.html
+++ b/frontend/packages/dashboard/src/dashboard.html
@@ -147,8 +147,10 @@
     <!-- P3RM1SS10NS: per-agent capability grants + tool-group
          assignments. Both tables are column-driven from the backend
          (GET /api/capabilities, GET /api/tool-groups) so new entries
-         require no UI change. Saving POSTs to the respective
-         /{agent} endpoint and queues a rebuild. -->
+         require no UI change. Edits stage in-browser across both
+         matrices; the single page-level "save all" button POSTs every
+         changed agent to /api/permissions in one atomic batch (caps +
+         groups coalesce into one rebuild per agent). -->
     <section class="tab-pane" id="tab-pane-permissions" data-tab-pane="permissions" hidden
              role="tabpanel" aria-labelledby="tab-permissions">
       <h2>◆ C4P4B1L1T13S ◆</h2>