diff --git a/docs/astryx-alignment-inventory.md b/docs/astryx-alignment-inventory.md
index 264191655b..f243eef4e6 100644
--- a/docs/astryx-alignment-inventory.md
+++ b/docs/astryx-alignment-inventory.md
@@ -1,3 +1,15 @@
+---
+doc_id: astryx-alignment-inventory
+title: "Astryx alignment inventory"
+language: en
+source_language: en
+implementation_status: current
+document_status: current
+translation_status: source-only
+last_verified: 2026-09-04
+owners:
+  - maka-backend
+---
 <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
diff --git a/docs/astryx-full-surface-audit.md b/docs/astryx-full-surface-audit.md
index 9ea0fe70ed..7f4fcd42e6 100644
--- a/docs/astryx-full-surface-audit.md
+++ b/docs/astryx-full-surface-audit.md
@@ -1,3 +1,15 @@
+---
+doc_id: astryx-full-surface-audit
+title: "Astryx full surface audit"
+language: en
+source_language: en
+implementation_status: current
+document_status: current
+translation_status: source-only
+last_verified: 2026-09-04
+owners:
+  - maka-backend
+---
 <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
@@ -23,6 +35,8 @@ Date: 2026-08-09
 Branch: `feat/astryx-surface-alignment`  
 Scope: every product surface under `apps/desktop/src/renderer/**` and `packages/ui/src/**` (183 inventory files).
 
+> **Status (verified 2026-09-05):** this is an audit record pinned to the `feat/astryx-surface-alignment` branch as of 2026-08-09; its citations and the 183-file inventory describe that tree. Since then the desktop surface has grown (the exact-head inventory generator reports 247 files at re-verification) and the settings kit was rebuilt — `SettingsSection` now implements open row groups and the memory/health pages use `MoreMenu` and `StatusDot`. The findings below are kept as written.
+
 This pass **read and analyzed** settings pages/modules, shell/chat/workbar/panels, module hubs, packages/ui compositions, and product CSS — not only inventory scripts.
 
 ## Verdict
diff --git a/docs/frontend-architecture-astryx-review-2026-08-09.md b/docs/frontend-architecture-astryx-review-2026-08-09.md
index 093b60ec33..d4bb0282c6 100644
--- a/docs/frontend-architecture-astryx-review-2026-08-09.md
+++ b/docs/frontend-architecture-astryx-review-2026-08-09.md
@@ -1,3 +1,15 @@
+---
+doc_id: frontend-architecture-astryx-review-2026-08-09
+title: "Frontend architecture & Astryx coverage review"
+language: en
+source_language: en
+implementation_status: current
+document_status: current
+translation_status: source-only
+last_verified: 2026-09-04
+owners:
+  - maka-backend
+---
 <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
@@ -25,6 +37,13 @@
 **Method:** file-level inventory regen + pattern scan + deep reads of shell/settings/modules/ui; prior art `docs/astryx-full-surface-audit.md`, `DESIGN.md`, `docs/astryx-surface-file-inventory.md`  
 **Evidence log:** goal scratch `frontend-review-scan.log` (inventory totals, greps, spot-checks, inventory unit tests)
 
+> **Status (verified 2026-09-04):** this is a review record pinned to the HEAD above; its
+> citations describe that tree. Since then the workbar moved under
+> `apps/desktop/src/renderer/features/workbar/` (so `session-workbar.tsx` /
+> `session-workbar-tabs.ts` / `use-shell-layout.ts` no longer sit at their cited paths)
+> and the Astryx core patch is now `patches/@astryxdesign+core+0.5.2.patch`. The findings
+> tables below are kept as written.
+
 ---
 
 ## Executive verdict
diff --git a/docs/frontend-css-governance.md b/docs/frontend-css-governance.md
index a89513f204..30d2fda915 100644
--- a/docs/frontend-css-governance.md
+++ b/docs/frontend-css-governance.md
@@ -1,3 +1,15 @@
+---
+doc_id: frontend-css-governance
+title: "Frontend CSS governance"
+language: en
+source_language: en
+implementation_status: current
+document_status: current
+translation_status: synced
+last_verified: 2026-09-04
+owners:
+  - maka-backend
+---
 <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
diff --git a/docs/frontend-css-governance.zh-CN.md b/docs/frontend-css-governance.zh-CN.md
index cbf34b11bb..4217247b5b 100644
--- a/docs/frontend-css-governance.zh-CN.md
+++ b/docs/frontend-css-governance.zh-CN.md
@@ -1,3 +1,15 @@
+---
+doc_id: frontend-css-governance.zh-CN
+title: "Frontend CSS governance"
+language: zh-CN
+source_language: en
+implementation_status: current
+document_status: current
+translation_status: synced
+last_verified: 2026-09-04
+owners:
+  - maka-backend
+---
 <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
diff --git a/docs/settings-astryx-deep-review.zh-CN.md b/docs/settings-astryx-deep-review.zh-CN.md
index 63e152b75d..eeec42bfd0 100644
--- a/docs/settings-astryx-deep-review.zh-CN.md
+++ b/docs/settings-astryx-deep-review.zh-CN.md
@@ -1,3 +1,15 @@
+---
+doc_id: settings-astryx-deep-review.zh-CN
+title: "Maka 设置页深度 Review——以 Astryx 设计语言为基准"
+language: zh-CN
+source_language: zh-CN
+implementation_status: current
+document_status: current
+translation_status: source-only
+last_verified: 2026-09-04
+owners:
+  - maka-backend
+---
 <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
@@ -22,6 +34,8 @@
 > 2026-08-03,基于 `settings/astryx-refactor` 分支(已 rebase 到最新 main)。
 > 审计方式:Storybook 全页截图(中/英 × 亮/暗)+ Astryx 官方 `settings` / `settings-dialog` 模板与 `astryx docs` 原文精读。
 
+> **状态(2026-09-05 核验):** 这是一份钉在 2026-08-03 `settings/astryx-refactor` 分支头上的评审记录,下文引用的卡片式布局等描述的都是当时的树。此后 `SettingsSection` 已重写为 open row-group 设计,memory/health 页也改用了 `MoreMenu` 与 `StatusDot`。以下发现按原文保留。
+
 ## 一、Astryx 官方设置语言到底是什么
 
 来自 CLI vendor 的官方模板(`@astryxdesign/cli/templates/pages/settings*`)与 `astryx docs principles / layout` 原文: