diff --git a/docs/help/gpt54-codex-agentic-parity-maintainers.md b/docs/help/gpt54-codex-agentic-parity-maintainers.md
index a602cfe1ca7..30fc634632f 100644
--- a/docs/help/gpt54-codex-agentic-parity-maintainers.md
+++ b/docs/help/gpt54-codex-agentic-parity-maintainers.md
@@ -1,3 +1,11 @@
+---
+title: "GPT-5.4 / Codex Parity Maintainer Notes"
+summary: "How to review the GPT-5.4 / Codex parity program as four merge units"
+read_when:
+  - Reviewing the GPT-5.4 / Codex parity PR series
+  - Maintaining the six-contract agentic architecture behind the parity program
+---
+
 # GPT-5.4 / Codex Parity Maintainer Notes
 
 This note explains how to review the GPT-5.4 / Codex parity program as four merge units without losing the original six-contract architecture.
diff --git a/docs/help/gpt54-codex-agentic-parity.md b/docs/help/gpt54-codex-agentic-parity.md
index 1ee8dd84a16..007f2c7e293 100644
--- a/docs/help/gpt54-codex-agentic-parity.md
+++ b/docs/help/gpt54-codex-agentic-parity.md
@@ -1,3 +1,12 @@
+---
+title: "GPT-5.4 / Codex Agentic Parity"
+summary: "How OpenClaw closes agentic execution gaps for GPT-5.4 and Codex-style models"
+read_when:
+  - Debugging GPT-5.4 or Codex agent behavior
+  - Comparing OpenClaw agentic behavior across frontier models
+  - Reviewing the strict-agentic, tool-schema, elevation, and replay fixes
+---
+
 # GPT-5.4 / Codex Agentic Parity in OpenClaw
 
 OpenClaw already worked well with tool-using frontier models, but GPT-5.4 and Codex-style models were still underperforming in a few practical ways: