diff --git a/docs/guide_ai_client.md b/docs/guide_ai_client.md
index f77baeb3..eb98443d 100644
--- a/docs/guide_ai_client.md
+++ b/docs/guide_ai_client.md
@@ -6,7 +6,7 @@
 
 ## Overview
 
-`src/ai_client.py` (~116KB) is the **unified LLM client** for 8 providers. It abstracts the differences between providers (Gemini, Anthropic, DeepSeek, MiniMax, Gemini CLI, Qwen, Grok, Llama) behind a single `send()` function.
+`src/ai_client.py` (~166KB) is the **unified LLM client** for 8 providers. It abstracts the differences between providers (Gemini, Anthropic, DeepSeek, MiniMax, Gemini CLI, Qwen, Grok, Llama) behind a single `send()` function.
 
 The module is a **stateful singleton** — all provider state is held in module-level globals. There is no class wrapping; the module itself is the abstraction layer.
 
@@ -510,7 +510,7 @@ print(r.data)
 
 - **[guide_architecture.md](guide_architecture.md#ai-client-multi-provider-architecture)** — Threading model and provider dispatch
 - **[guide_mma.md](guide_mma.md#tier-3-worker-lifecycle-run_worker_lifecycle)** — How Tier 3 workers use ai_client
-- **[guide_mcp_client.md](guide_mcp_client.md)** — The 46 tools that ai_client can invoke (canonical list in `models.AGENT_TOOL_NAMES`)
+- **[guide_mcp_client.md](guide_mcp_client.md)** — The 45 MCP tools (plus the PowerShell shell tool defined here in ai_client.py) that ai_client can invoke (canonical list in `models.AGENT_TOOL_NAMES`)
 - **[guide_rag.md](guide_rag.md)** — RAG engine integration via `rag_engine` parameter
 - **[guide_state_lifecycle.md](guide_state_lifecycle.md)** — The per-provider history globals (`_anthropic_history`, etc.) are managed here; their locking and reset behavior is documented
 - **[guide_context_aggregation.md](guide_context_aggregation.md)** — The `aggregate.py` pipeline that produces the markdown the AI client sends
diff --git a/docs/guide_context_curation.md b/docs/guide_context_curation.md
index 0f648f17..9de197b8 100644
--- a/docs/guide_context_curation.md
+++ b/docs/guide_context_curation.md
@@ -319,7 +319,7 @@ This is a UX consolidation, not a data model change. The underlying `ast_mask: d
 
 - **[guide_context_aggregation.md](guide_context_aggregation.md)** — The full `aggregate.py` pipeline that consumes the FileItem schema documented here. Includes the 7 `view_mode` values (`full`, `summary`, `skeleton`, `outline`, `masked`, `none`, `custom`) and the 3 `aggregation_strategy` values (`auto`, `summarize`, `full`)
 - **[guide_context_presets.md](guide_context_aggregation.md)** — now part of the Context Aggregation guide — The `ContextPreset` schema (named, persisted set of FileItems)
-- **[guide_models.md](guide_models.md)** — Full FileItem and ContextPreset dataclass definitions at `src/models.py:510` and `src/models.py:909`
+- **[guide_models.md](guide_models.md)** — Full FileItem and ContextPreset dataclass definitions (now in `src/project_files.py` and `src/context_presets.py` respectively; moved out of `src/models.py` per `module_taxonomy_refactor_20260627`)
 - **[guide_architecture.md](guide_architecture.md)** — How the FileItem list is built up in `App.init_state` and how the aggregation pipeline consumes it
 - **[conductor/tracks/nagent_review_20260608/report.md §6](../conductor/tracks/nagent_review_20260608/report.md)** — Deep-dive on per-file memory; compares Manual Slop's curation dimension (this guide) to nagent's conversation-log dimension
 - **[conductor/tracks/nagent_review_20260608/nagent_takeaways_20260608.md §4](../conductor/tracks/nagent_review_20260608/nagent_takeaways_20260608.md)** — Actionable: add a `file_id: st_dev:st_ino` field to FileItem for rename-safe identity
diff --git a/docs/guide_gui_2.md b/docs/guide_gui_2.md
index 72c7a7af..68388727 100644
--- a/docs/guide_gui_2.md
+++ b/docs/guide_gui_2.md
@@ -6,7 +6,7 @@
 
 ## Overview
 
-`src/gui_2.py` is the **largest file** in the project (~260KB, ~5400 lines). It contains the `App` class — the main ImGui application orchestrator — and ~90 module-level render functions that draw the GUI.
+`src/gui_2.py` is the **largest file** in the project (~437KB, ~8970 lines as of 2026-07-02; was ~260KB / ~5400 lines when this guide was first written — extended by the 2026-07 hot-reload and event-sourcing refactors). It contains the `App` class — the main ImGui application orchestrator — and ~90 module-level render functions that draw the GUI.
 
 The file is divided into: