diff --git a/Agent.md b/Agent.md
index cb697b76..4363dffe 100644
--- a/Agent.md
+++ b/Agent.md
@@ -94,6 +94,7 @@ pkill -f "emrg.server"; rm -f ~/.emrg/emrgd.port; python -m emrg
 
 Python: `uv run pytest tests/ -v` (473) — import check: `uv run python -c "from emrg.client.app import run_client"`
 GUI: `cd emrg/gui && npm test` (44: 22 daemon_client + 7 integration + 15 renderer smoke) — syntax: `node --check main.js preload.js daemon_client.js renderer/js/*.js`
+CI: `uv run pytest` + GUI tests + **actionlint workflow lint** (`rhysd/actionlint@v1.7.12` gate, #444 — workflow 解析错误在 PR CI 即失败，如 `if:` secrets 上下文)
 
 ## Configuration
 
diff --git a/README.en.md b/README.en.md
index bb78cae1..375e837d 100644
--- a/README.en.md
+++ b/README.en.md
@@ -265,6 +265,7 @@ cd emrg
 uv sync              # install deps
 uv run pytest tests/ -v   # run tests (currently 473 items)
 uv run python -m emrg     # launch TUI
+# CI includes actionlint workflow gate (#444): workflow parse errors fail PR CI
 
 # Optional: Electron GUI (non-developer entry point, Phase 3)
 cd emrg/gui
diff --git a/README.md b/README.md
index ffc71ae4..2809ba65 100644
--- a/README.md
+++ b/README.md
@@ -281,6 +281,7 @@ cd emrg
 uv sync              # 安装依赖
 uv run pytest tests/ -v   # 跑测试（当前 473 项）
 uv run python -m emrg     # 启动 TUI
+# CI 含 actionlint workflow 门禁（#444）：workflow 解析错误在 PR 即失败
 
 # 可选：Electron GUI（非开发者主入口，Phase 3）
 cd emrg/gui