diff --git a/apps/ai-game-creator-shell/src-tauri/src/agent.rs b/apps/ai-game-creator-shell/src-tauri/src/agent.rs
index 213b69875..57da398bf 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/agent.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/agent.rs
@@ -31,9 +31,9 @@ mod direct_validation;
 pub(crate) use direct_validation::browser_tool_result;
 mod generation;
 pub(crate) mod json_sidecar;
+mod provider_request_snapshot;
 pub(crate) mod redaction;
 mod runtime_error;
-mod runtime_models;
 mod skill_pack;
 mod task_lock;
 mod thread_manager;
@@ -75,9 +75,9 @@ pub(crate) use direct_tools_mcp::*;
 pub(crate) use direct_validation::DirectValidationConfig;
 pub(crate) use generation::*;
 pub(crate) use json_sidecar::*;
+pub(in crate::agent) use provider_request_snapshot::*;
 pub(crate) use redaction::*;
 pub(crate) use runtime_error::*;
-pub(in crate::agent) use runtime_models::*;
 pub(crate) use skill_pack::*;
 pub(crate) use task_lock::*;
 pub(crate) use thread_manager::queue::*;
diff --git a/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs b/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs
index 1e4f4fb6b..abf1ad1a2 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs
@@ -1,8 +1,8 @@
 use super::*;
 
 mod canvas_generation;
-mod draft_validation;
 mod external_generation_state;
+mod game_html_validation;
 mod loop_orchestration;
 mod prompt_context;
 mod trace;
@@ -32,9 +32,6 @@ pub(crate) use canvas_generation::{
     platform_art_runtime_references_match_request_contract, validate_platform_art_icon_prompt,
     PlatformArtAssetGenerationOptions, PLATFORM_ART_ASSET_GENERATION_KINDS,
 };
-pub(crate) use draft_validation::{
-    contains_any, fnv1a64, strip_llm_thinking_blocks, validate_game_html_smoke,
-};
 #[cfg(test)]
 pub(crate) use external_generation_state::platform_art_generation_legacy_external_configuration_fingerprint;
 #[cfg(test)]
@@ -49,6 +46,9 @@ pub(in crate::agent) use external_generation_state::{
     game_creator_agent_runtime_external_generation_exists,
     remove_platform_art_generation_runtime_state_at, PlatformArtGenerationRuntimeContext,
 };
+pub(crate) use game_html_validation::{
+    contains_any, fnv1a64, strip_llm_thinking_blocks, validate_game_html_smoke,
+};
 pub(crate) use loop_orchestration::{
     game_creator_agent_llm_error_is_mud_points_insufficient,
     game_creator_agent_llm_error_public_summary, request_game_creator_llm_text,
diff --git a/apps/ai-game-creator-shell/src-tauri/src/agent/generation/draft_validation.rs b/apps/ai-game-creator-shell/src-tauri/src/agent/generation/game_html_validation.rs
similarity index 98%
rename from apps/ai-game-creator-shell/src-tauri/src/agent/generation/draft_validation.rs
rename to apps/ai-game-creator-shell/src-tauri/src/agent/generation/game_html_validation.rs
index 9f178c15a..a3cc7c722 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/agent/generation/draft_validation.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/agent/generation/game_html_validation.rs
@@ -1,3 +1,7 @@
+//! 游戏 HTML / JS 校验原语：静态冒烟自检与生成链共用。
+//!
+//! 草案（draft）与多 pass 校验链已随 Agent Runtime 退役删除；本模块只保留校验。
+
 use oxc_allocator::Allocator as JavascriptAllocator;
 use oxc_parser::Parser as JavascriptParser;
 use oxc_semantic::SemanticBuilder as JavascriptSemanticBuilder;
diff --git a/apps/ai-game-creator-shell/src-tauri/src/agent/runtime_models.rs b/apps/ai-game-creator-shell/src-tauri/src/agent/provider_request_snapshot.rs
similarity index 88%
rename from apps/ai-game-creator-shell/src-tauri/src/agent/runtime_models.rs
rename to apps/ai-game-creator-shell/src-tauri/src/agent/provider_request_snapshot.rs
index 7e8a8ecbc..b973925a5 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/agent/runtime_models.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/agent/provider_request_snapshot.rs
@@ -1,3 +1,5 @@
+//! Provider 请求身份快照：退役的 Agent Runtime 计划 / 观察 DTO 已删除，本模块只保留这一个结构。
+
 /// 一次 Provider 请求的身份快照：退役的 Agent Runtime 计划/观察 DTO 已删除，
 /// 只保留仍被 Codex app-server 会话与 provider 请求路径使用的这个结构。
 #[derive(Clone, Debug, Eq, PartialEq)]
diff --git a/apps/ai-game-creator-shell/src-tauri/src/process_session.rs b/apps/ai-game-creator-shell/src-tauri/src/process_session.rs
index 9b3a15145..852080a3f 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/process_session.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/process_session.rs
@@ -5,10 +5,10 @@ use std::collections::HashMap;
 use crate::process_session_bridge::*;
 
 mod model;
-mod recovery;
+mod shutdown;
 
 pub(crate) use model::*;
-pub(crate) use recovery::*;
+pub(crate) use shutdown::*;
 
 #[cfg(test)]
 mod tests;
diff --git a/apps/ai-game-creator-shell/src-tauri/src/process_session/recovery.rs b/apps/ai-game-creator-shell/src-tauri/src/process_session/shutdown.rs
similarity index 94%
rename from apps/ai-game-creator-shell/src-tauri/src/process_session/recovery.rs
rename to apps/ai-game-creator-shell/src-tauri/src/process_session/shutdown.rs
index 0d24d477c..e73457218 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/process_session/recovery.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/process_session/shutdown.rs
@@ -1,3 +1,7 @@
+//! process session 关闭入口：`shutdown_all_process_sessions*`。
+//!
+//! 会话恢复 / 重建逻辑已随退役批次删除，本模块只剩关闭语义。
+
 use super::*;
 
 pub(crate) fn shutdown_all_process_sessions() {