diff --git a/CLAUDE.md b/CLAUDE.md
index 532d7c6..a8d4e37 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2,6 +2,8 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+**Important:** When updating this file, always update `README.md` as well. The README is the main user-facing documentation for the project.
+
 ## Project Overview
 
 Kao is a minimalist system status monitor designed for an old Pixel phone used as an ambient display. It uses ASCII "emotes" to represent system health instead of complex graphs.