diff --git a/README.md b/README.md
index e69de29..6445d8b 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,11 @@
+# gxtyzx-java
+
+构建、运行与测试以仓库根 `AGENTS.md` 为准。要点：JDK 16+、默认 profile `gxtyzx-test`、端口 9099。
+
+```bash
+./mvnw -DskipTests package
+./mvnw verify -Papproval-it   # 集成测试，使用 gxtyzx-test 共享库
+./mvnw spring-boot:run
+```
+
+`src/test/resources/db/` 为空，没有本地 schema 种子；不要从旧 `target/` 产物恢复建表脚本。