diff --git a/src/databases/officer_db/src/schema.ts b/src/databases/officer_db/src/schema.ts
index cb9d738c..e551b13c 100644
--- a/src/databases/officer_db/src/schema.ts
+++ b/src/databases/officer_db/src/schema.ts
@@ -10,14 +10,16 @@
 //
 // ── Core, and plugins ──
 //
-// A fresh install creates the core tables only. Everything under "plugins" is a table belonging to a
-// sidecar that a light install does not run — `ecosystem.light.config.cjs` plus `officer-headscale`,
-// which is core because the tailnet is the perimeter (see docs/secret-store.md).
+// A fresh install creates the core tables only. Everything under "plugins" belongs to a sidecar a
+// baseline install does not run.
 //
-// The plugin lines are kept, commented, rather than deleted. They are the record of what a table is
-// called and which file defines it, and the plugin-install story is going to need exactly that. Nothing
-// creates them yet: installing a plugin will have to uncomment its line and push, and building that is
-// still ahead of us.
+// A plugin's tables are NOT among them any more: a plugin owns its schema at
+// `plugins/<name>/db/schema.ts`, and installing it regenerates `plugin-schemas.gen.ts` (imported at the
+// bottom of this file) and runs `db:push`. Offscale was the first out, on 2026-08-15.
+//
+// The commented lines below are kept rather than deleted. They record what each remaining sidecar's
+// tables are called and which file defines them — which is exactly what each one needs when its turn to
+// be extracted comes.
 
 // ── Core ─────────────────────────────────────────────────────────────────────────────────────────