diff --git a/stock/app/holdings_intel.py b/stock/app/holdings_intel.py
index c79745d..faa24e1 100644
--- a/stock/app/holdings_intel.py
+++ b/stock/app/holdings_intel.py
@@ -117,7 +117,11 @@ ADD_SCORE = 70.0   # 이 이상이면 추가매수 후보
 
 
 def decide_action(tech_score: float, exit_flags: dict, pnl: float | None) -> tuple[str, str]:
-    """우선순위: sell > trim > add > hold. 근거 텍스트 동봉."""
+    """액션 결정 매트릭스: sell > trim > add > hold (우선순위 순).
+
+    Returns:
+        (action, reasons_text)  action ∈ {"sell","trim","add","hold"}
+    """
     reasons = []
     # 청산 (최우선)
     if exit_flags.get("stop_loss"):