diff --git a/system-dev/wiki/principles.md b/system-dev/wiki/principles.md
index 231fbea..9d4b3d5 100644
--- a/system-dev/wiki/principles.md
+++ b/system-dev/wiki/principles.md
@@ -24,3 +24,4 @@
 - **任何 code 變動前先讀對應 SDD 並宣告**：找不到對應 SDD → 停手問 richblack，不自行新建。
 - **每完成一個 task 立刻更新 tasks.md `[x]`**，不批次。
 - **缺能力的自力救濟階梯**：自家 API 缺→補 API；第三方 API 缺→workflow/code-node 補丁（非建零件）；純計算→code-node；真需新穩定能力才零件 PR。
+- **前端要人類友善，Arcrun 要 AI 友善——兩者都從終點看**（leo 2026-07-21）：前端＝讓人或 AI **輕易拿到查詢結果**；Arcrun＝**讓 AI 輕易建立程式碼**。驗收判準＝「**AI 覺得 Arcrun 比 Python 還簡單，因此沒有寫 Python 的慾望**；至少可忍受、跟 Python 同級，**絕不可迷路、搞不懂**」。使用方式應為**意圖驅動**：使用者不用想有哪些零件，只描述「想達成什麼目的的過程」→ **機器給零件/recipe/workflow 建議** → 用 `>>` 把建議黏起來。**設計入口時問「這是為造零件的人設計，還是為有意圖的人設計？」**——前者會把使用者推向最難的路（實證：2026-07-21 總管做「定期打 API 然後通知」，Python 10 行，Arcrun 花 40 分鐘未完成，全程被 component guide／publish_component 建議推向鑄零件）。