1 files changed, 11 insertions, 2 deletions

diff --git a/AGENTS.md b/AGENTS.md
index 3908c2d..c3b555d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -59,11 +59,20 @@
   receives `Command` or a finished line through `submit_line`, never a key.
 - egui lives in the `gui/` workspace member. Its dependencies must never
   enter the TUI or server build graph: no GUI crate in the root package's
-  `[dependencies]`.
+  `[dependencies]`. The GUI may depend on the core, never the reverse.
+- Build the GUI with `cargo build -p zagan-bet-gui --profile gui-release`;
+  the profile lives at the workspace root because a member's is ignored.
+- Colours, spacing and font sizes come from `gui/src/theme.rs`; screens must
+  not hard-code them. The embedded fonts are Open Sans (OFL) and Hack (MIT);
+  ship their licence files with any change.
+- GUI integration tests live in `gui/tests/`, because the root package cannot
+  depend on the GUI.
 - First contact shows the fingerprint and waits for a decision before sending
   any credentials. A changed key is a hard stop; forgetting it is explicit.
 - The GUI is themed deliberately. Default egui styling is not an acceptable
-  look; keep a style module and a reference screen.
+  look; keep a style module and a reference screen. The palette is derived
+  from the terminal's ANSI colours, and felt green is only ever the roulette
+  table.
 
 ## Client TUI
 - `render_lines()` and `render()` must agree. If `render()` uses `\r\n`,