diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 8edf46a..cf312dd 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -17,6 +17,11 @@ tools/*       工程层：只在构建期读各包 ua.manifest.json / tokens.jso
               不 import 任何运行时代码
 ```
 
+浮层定位是皮肤层内部的横切关注点，统一走 `packages/skin/ui/src/position.ts`：
+- `flip` / `flipSide`：按视口几何判定上下（四向）翻转，只在**打开那一刻**算一次；
+- `trackShift(onShift)`：展开期间的位移跟随——捕获阶段监听 scroll（容器滚动不冒泡）与 resize，rAF 节流，返回释放函数；
+- 各弹层（tooltip / select / autoComplete / cascader / colorPicker / datePicker / timePicker / menu / multiSelect）一律「打开算一次 + 展开期间 trackShift + 收起调释放函数」，只写「打开算一次」的版本会在用户滚动后把弹层压到视口边缘。
+
 ## 目录结构
 
 ```