豆豆友情提示:这是一个非官方 GitHub 代理镜像,主要用于网络测试或访问加速。请勿在此进行登录、注册或处理任何敏感信息。进行这些操作请务必访问官方网站 github.com。 Raw 内容也通过此代理提供。
Skip to content
This repository was archived by the owner on Apr 16, 2026. It is now read-only.

Commit 891b2b7

Browse files
natorionwolfib
authored andcommitted
docs: Add 'Progressive Complexity' and 'Reference over Value' design principles. (ChromeDevTools#939)
1 parent 6e29930 commit 891b2b7

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

docs/design-principles.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,3 +8,5 @@ Apply them with nuance.
88
- **Small, Deterministic Blocks**: Give agents composable tools (Click, Screenshot), not magic buttons.
99
- **Self-Healing Errors**: Return actionable errors that include context and potential fixes.
1010
- **Human-Agent Collaboration**: Output must be readable by machines (structured) AND humans (summaries).
11+
- **Progressive Complexity**: Tools should be simple by default (high-level actions) but offer advanced optional arguments for power users.
12+
- **Reference over Value**: for heavy assets (screenshots, traces, videos), return a file path or resource URI, never the raw data stream. Some MCP clients support a built-in handling of heavy assets e.g. directly displaying images. This _could_ be an exception.

0 commit comments

Comments
 (0)