diff --git a/docs/specs/claw-supervisor.md b/docs/specs/claw-supervisor.md
index f29794dec1ba..d52f9eefaa80 100644
--- a/docs/specs/claw-supervisor.md
+++ b/docs/specs/claw-supervisor.md
@@ -1,7 +1,7 @@
 ---
 title: Claw Supervisor
-description: Fleet supervision plan for Codex app-server sessions controlled by OpenClaw.
-readWhen:
+summary: "Fleet supervision plan for Codex app-server sessions controlled by OpenClaw."
+read_when:
   - Designing Codex fleet supervision
   - Building OpenClaw tools that read, steer, or spawn Codex sessions
   - Choosing between local, Cloudflare, and VPS deployment for supervised Codex
diff --git a/scripts/codespell-ignore.txt b/scripts/codespell-ignore.txt
index d957c052f59d..7946e2cb3ef2 100644
--- a/scripts/codespell-ignore.txt
+++ b/scripts/codespell-ignore.txt
@@ -12,3 +12,5 @@ Ballance
 optIn
 Brining
 wit
+allowIn
+planText