diff --git a/codex-rs/tui/src/bottom_pane/AGENTS.md b/codex-rs/tui/src/bottom_pane/AGENTS.md
index b5328217db73..b07fa2eca8d5 100644
--- a/codex-rs/tui/src/bottom_pane/AGENTS.md
+++ b/codex-rs/tui/src/bottom_pane/AGENTS.md
@@ -4,8 +4,6 @@ When changing the paste-burst or chat-composer state machines in this folder, ke
 
 - Update the relevant module docs (`chat_composer.rs` and/or `paste_burst.rs`) so they remain a
   readable, top-down explanation of the current behavior.
-- Update the narrative doc `docs/tui-chat-composer.md` whenever behavior/assumptions change (Enter
-  handling, retro-capture, flush/clear rules, `disable_paste_burst`, non-ASCII/IME handling).
 - Keep implementations/docstrings aligned unless a divergence is intentional and documented.
 
 Practical check:
diff --git a/codex-rs/tui/src/bottom_pane/chat_composer.rs b/codex-rs/tui/src/bottom_pane/chat_composer.rs
index 8fcda378fc5f..64252a57ada1 100644
--- a/codex-rs/tui/src/bottom_pane/chat_composer.rs
+++ b/codex-rs/tui/src/bottom_pane/chat_composer.rs
@@ -111,7 +111,6 @@
 //! composer flushes/clears any in-flight burst state so it cannot leak into subsequent input.
 //!
 //! For the detailed burst state machine, see `codex-rs/tui/src/bottom_pane/paste_burst.rs`.
-//! For a narrative overview of the combined state machine, see `docs/tui-chat-composer.md`.
 //!
 //! # PasteBurst Integration Points
 //!
diff --git a/codex-rs/tui/src/bottom_pane/paste_burst.rs b/codex-rs/tui/src/bottom_pane/paste_burst.rs
index 44e3898db656..4ea8310c35d4 100644
--- a/codex-rs/tui/src/bottom_pane/paste_burst.rs
+++ b/codex-rs/tui/src/bottom_pane/paste_burst.rs
@@ -16,9 +16,6 @@
 //! - buffer a burst as a single pasted string, or
 //! - let input flow through as normal typing.
 //!
-//! For the higher-level view of how `PasteBurst` integrates with `ChatComposer`, see
-//! `docs/tui-chat-composer.md`.
-//!
 //! # Call Pattern
 //!
 //! `PasteBurst` is a pure state machine: it never mutates the textarea directly. The caller feeds