diff --git a/doc/plugins/PLUGIN_AUTHORING_GUIDE.md b/doc/plugins/PLUGIN_AUTHORING_GUIDE.md
index d6e71df9dbd..d13ccb8d84a 100644
--- a/doc/plugins/PLUGIN_AUTHORING_GUIDE.md
+++ b/doc/plugins/PLUGIN_AUTHORING_GUIDE.md
@@ -248,7 +248,6 @@ const manifest: PaperclipPluginManifestV1 = {
     {
       skillKey: "weekly-brief-skills",
       displayName: "Weekly Briefer",
-      slug: "weekly-brief-skills",
       description: "Reusable skill for the managed research workflow.",
     },
   ],
diff --git a/doc/plugins/PLUGIN_SPEC.md b/doc/plugins/PLUGIN_SPEC.md
index e8cda1de932..b85b87df72b 100644
--- a/doc/plugins/PLUGIN_SPEC.md
+++ b/doc/plugins/PLUGIN_SPEC.md
@@ -345,6 +345,7 @@ export interface PaperclipPluginManifestV1 {
   routines?: PluginManagedRoutineDeclaration[];
   skills?: PluginManagedSkillDeclaration[];
   localFolders?: PluginLocalFolderDeclaration[];
+  /** Legacy top-level launcher declarations. Prefer `ui.launchers` for new manifests. */
   launchers?: PluginLauncherDeclaration[];
   ui?: {
     launchers?: PluginLauncherDeclaration[];