diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..fb15028
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,10 @@
+# AGENTS.md
+
+git workspace 位于 `.worktrees` 之下，可能看到：
+
+- release 分支：发布分支，用户能够使用的
+- harness 分支：仅保留 harness 功能
+- harness-feature 分支：core-feature-{功能名称}
+- develop-feature 分支：develop-feature-{功能名称}
+
+根目录一般位于 main 或者 develop 分支上