From 5c40b7e63321cf39a27410ce96fb4bfb0082878b Mon Sep 17 00:00:00 2001
From: "DESKTOP-PUHFO60\\dsx2016" <evan199101@gmail.com>
Date: Fri, 23 Oct 2026 12:37:57 +0800
Subject: [PATCH] Document CYD project conventions for the next test repo.

Point README/AGENTS at the shared CYD_PROJECT_GUIDE (LVGL, flashable firmware, local git).

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 AGENTS.md | 13 +++++++++++++
 README.md |  2 ++
 2 files changed, 15 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..6d7590b
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,13 @@
+# 本仓库给 AI / 协作者
+
+完整开工约定（LVGL+触控、可刷固件、本地 git、目录结构、灯类参考）：
+
+**[`../CYD_PROJECT_GUIDE.md`](../CYD_PROJECT_GUIDE.md)**
+
+本工程是 **KY-009 RGB** 参考实现：颜色切换 + PWM + `firmware/cyd` 可刷包。
+
+## 收工三件套（每次改动）
+
+1. `pio run -e cyd -t upload`
+2. `.\firmware\export_from_build.ps1`
+3. 本地 `git commit`
diff --git a/README.md b/README.md
index a66484c..f6d003e 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 触控 + LVGL 参考 `hw269test` / `tftest`。一次只亮一路颜色，可切换 R/G/B + 调亮度。
 
+> **新开 CYD 测试工程请先读：** [`../CYD_PROJECT_GUIDE.md`](../CYD_PROJECT_GUIDE.md)（LVGL/触控、可刷固件、本地 git、目录结构）。本仓另见 [`AGENTS.md`](AGENTS.md)。
+
 ## 硬件
 
 | 项目 | 说明 |