diff --git a/frontend/packages/shared/src/terminal.css b/frontend/packages/shared/src/terminal.css
index 1aeb0e5c..bdbc9903 100644
--- a/frontend/packages/shared/src/terminal.css
+++ b/frontend/packages/shared/src/terminal.css
@@ -6,13 +6,15 @@
    colour; pages that don't emit a given kind simply never produce that
    class — the unused rule sits in the bundle harmlessly.
 
-   `.terminal-wrap` provides the crust-on-black phosphor chrome that makes
-   the agent page feel like a terminal. Pages can opt in by wrapping a
-   block in this class; or skip it and the rows still render with their
-   class colours, just without the frame.
+   `.terminal-wrap` provides the crust-on-black phosphor chrome that
+   makes the agent page feel like a terminal. Pages can opt in by
+   wrapping a block in this class; or skip it and the rows still render
+   with their class colours, just without the frame.
 
-   No `.term-input` here — composers are a separate concern (see
-   hive-fr0nt::COMPOSER_CSS / COMPOSER_JS once introduced). */
+   No `.term-input` here — composers are a separate concern, owned by
+   each page's own CSS. Row taxonomy + layout contract documented in
+   `docs/web-ui.md::Shared terminal pane` and
+   `docs/terminal-rendering.md`. */
 
 .terminal-wrap {
   position: relative;