apple-design-skill 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "apple-design-skill",
3
- "version": "0.0.1",
4
- "description": "Apple-style interface design with complete dropdown verification and optional multi-agent collaboration.",
3
+ "version": "0.0.2",
4
+ "description": "Apple-style interface design with complete dropdown verification.",
5
5
  "author": {
6
6
  "name": "yqstar",
7
7
  "url": "https://github.com/yqstar"
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "apple-design-skill",
3
- "version": "0.0.1",
4
- "description": "Apple-style interface design, complete dropdown verification, and optional multi-agent collaboration.",
3
+ "version": "0.0.2",
4
+ "description": "Apple-style interface design with complete dropdown verification.",
5
5
  "author": {
6
6
  "name": "yqstar",
7
7
  "url": "https://github.com/yqstar"
@@ -13,7 +13,7 @@
13
13
  "interface": {
14
14
  "displayName": "Apple Design",
15
15
  "shortDescription": "Consistent interfaces across coding agents.",
16
- "longDescription": "Design and review Apple-style web interfaces, including complete dropdown appearance, keyboard behavior, accessibility, and coordinated multi-agent work.",
16
+ "longDescription": "Design and review Apple-style web interfaces, including complete dropdown appearance, keyboard behavior, and accessibility.",
17
17
  "developerName": "yqstar",
18
18
  "category": "Productivity",
19
19
  "capabilities": [
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.0.2
4
+
5
+ - Remove multi-agent collaboration guidance and related package and plugin descriptions.
6
+ - Reorganize the README around a real before/after example, quick start, use cases and repository structure.
7
+ - Add installation, release and contribution guides, with dated references to established Skill repositories.
8
+ - Include the final Agent Lab pages and three screenshots; check example resources in CI while keeping them outside the npm package.
9
+
3
10
  ## 0.0.1
4
11
 
5
12
  - First non-prerelease version, published through the GitHub Actions OIDC workflow.
package/README.md CHANGED
@@ -1,167 +1,120 @@
1
1
  # Apple Design Skill
2
2
 
3
- [![CI](https://github.com/yqstar/apple-design-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/yqstar/apple-design-skill/actions/workflows/ci.yml)
4
- [![npm](https://img.shields.io/npm/v/apple-design-skill)](https://www.npmjs.com/package/apple-design-skill)
3
+ **让 Apple 风格贯穿整个界面,从页面布局到展开后的下拉菜单。**
5
4
 
6
- 一个可用于 **Codex、Claude Code、Cursor 和 Agent Skills 兼容工具**的 Apple 风格界面设计技能。重点覆盖完整下拉菜单、视觉一致性、键盘与焦点行为,以及按需启用的多 Agent 协作。
5
+ Codex、Claude Code、Cursor 和 Agent Skills 兼容工具提供设计、实现与审查指引,重点关注视觉一致性、键盘与焦点,以及需要时的手势交互。
7
6
 
8
- 这是基于 Apple 设计资料的 Web 实践指南,**不是 Apple 官方规范或官方产品**。技能提供工作指引,不包含模型服务、Agent 运行时或付费 API。
7
+ [![CI](https://github.com/yqstar/apple-design-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/yqstar/apple-design-skill/actions/workflows/ci.yml)
8
+ [![npm](https://img.shields.io/npm/v/apple-design-skill)](https://www.npmjs.com/package/apple-design-skill)
9
+ [![MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
9
10
 
10
- ## 安装
11
+ [快速开始](#快速开始) · [使用前后对比](#使用前后对比) · [安装与版本管理](docs/installation.md) · [参与贡献](CONTRIBUTING.md)
11
12
 
12
- 需要 Node.js 22 或更新版本。npm 安装包时不会自动写入 Agent 配置;下面的 `install` 命令才会安装技能。
13
+ 在目标项目中安装给 Codex(Node.js 22+):
13
14
 
14
15
  ```sh
15
- # 当前项目:同时安装给 Codex、Claude Code 和 Cursor
16
- npx apple-design-skill@latest install --all
17
-
18
- # 固定版本,适合团队复现
19
- npx apple-design-skill@0.0.1 install --all --project .
20
-
21
- # 只安装给指定工具,可使用逗号或重复 --agent
22
- npx apple-design-skill@0.0.1 install --agent codex,claude
23
-
24
- # 用户级安装
25
- npx apple-design-skill@0.0.1 install --agent cursor --global
26
-
27
- # 不指定工具:安装到通用 .agents/skills
28
- npx apple-design-skill@0.0.1 install
29
-
30
- # 提前查看目标路径,不写入文件
31
- npx apple-design-skill@0.0.1 install --all --dry-run
16
+ npx apple-design-skill@latest install --agent codex
32
17
  ```
33
18
 
34
- | 目标 | 项目级目录 | 用户级目录 |
35
- | --- | --- | --- |
36
- | `codex` / `universal` | `.agents/skills/apple-design-skill` | `~/.agents/skills/apple-design-skill` |
37
- | `claude` | `.claude/skills/apple-design-skill` | `~/.claude/skills/apple-design-skill` |
38
- | `cursor` | `.cursor/skills/apple-design-skill` | `~/.cursor/skills/apple-design-skill` |
39
-
40
- 路径遵循 [Codex 本地技能发现](https://learn.chatgpt.com/docs/build-skills#where-codex-loads-local-skills)、[Claude Code Skills](https://code.claude.com/docs/en/skills) 和 [Cursor Skills](https://prod.cursor.com/docs/skills) 文档。Cursor 还可能发现 `.agents`、`.claude` 等兼容目录;同时使用多个工具时,`--all` 的复制安装可能在某些工具内显示同名入口。只使用 Codex 与 Cursor 时,单独安装 `--agent universal` 可避免重复副本。
41
-
42
- 已有 `~/.codex/skills/apple-design-skill` 等旧目录不会被静默迁移或删除。新目录与旧目录可能同时被发现,请在确认新版本可用后自行整理旧副本。
43
-
44
- ## 升级、回退和多版本并存
45
-
46
- `npx 包名@版本` 决定安装器携带的技能版本。安装后,该版本的完整快照保存在当前作用域的 `.apple-design-skill/versions/<版本>`,位于 Agent 自动发现目录之外;实际使用的是复制到 Agent 目录的活动版本。
47
-
48
- ```sh
49
- # 升级到最新稳定版本;干净的受管理副本可直接更新
50
- npx apple-design-skill@latest install --all
19
+ 使用 Claude Code Cursor?见[快速开始](#快速开始)。
51
20
 
52
- # 安装候选版(不影响 latest 指向)
53
- npx apple-design-skill@next install --name apple-design-preview
21
+ ## 使用前后对比
54
22
 
55
- # 查看当前作用域缓存的版本与所选工具的活动版本
56
- npx apple-design-skill@latest list --all
23
+ 同一份 Agent Lab 中文学习页需求,同样的六节课程、Python 示例、自测与本机进度。左侧为未读取 Skill 完整指令的基础版,右侧为读取后的 Apple 版。
57
24
 
58
- # 切换回已安装过的版本;use 不下载技能内容
59
- npx apple-design-skill@latest use 0.0.1 --all
25
+ [![Agent Lab 桌面对照:左侧基础版,右侧使用 Apple Design Skill 后的版本](examples/agent-learning-compare/screenshots/comparison-desktop.jpg)](examples/agent-learning-compare/screenshots/comparison-desktop.jpg)
60
26
 
61
- # 尚未缓存的旧版本,直接从 npm 按精确版本安装
62
- npx apple-design-skill@1.0.0-rc.1 install --all
27
+ | 维度 | 未使用 Skill · A | 使用 Skill · B |
28
+ | --- | --- | --- |
29
+ | 导航与布局 | 深色侧栏,主区域紧凑 | 浅色顶部导航,更充裕的内容间距 |
30
+ | 视觉层级 | 深色学习卡片、青绿色主按钮 | 浅蓝学习卡片、蓝色主按钮 |
31
+ | 组件一致性 | 小圆角、可见边框、彩色课程图标 | 统一视觉变量、卡片圆角与中性色图标 |
32
+ | 下拉菜单 | 原生 `select`,展开外观由系统决定 | 自定义 combobox,触发器和展开列表统一设计 |
33
+ | 实现取舍 | 原生控件的维护成本较低 | 完整控制菜单外观,同时需要维护键盘、定位和焦点逻辑 |
63
34
 
64
- # 两个版本同时保留,使用不同的技能名称
65
- npx apple-design-skill@1.0.0-rc.1 install --name apple-design-preview --agent codex
66
- npx apple-design-skill@0.0.1 install --name apple-design-stable --agent codex
67
- ```
35
+ 更多效果:[手机对照](examples/agent-learning-compare/screenshots/comparison-mobile.jpg) · [展开菜单](examples/agent-learning-compare/screenshots/apple-menu-desktop.jpg)。
68
36
 
69
- 并存安装会同时修改 `SKILL.md` 中的 `name` 和 Codex 元数据里的调用名称。因此可以明确调用 `$apple-design-preview` 或 `$apple-design-stable`,不会让两个版本共享同一个技能名称。自动选择时仍有可能同时匹配相似描述,做版本对照时请显式指定要使用的名称。
37
+ 这是同一实现者顺序完成的设计对照,仅展示本次实现差异。[查看示例说明](examples/agent-learning-compare/README.md)。
70
38
 
71
- `use` 本身可以离线使用;`npx @latest` 仍可能访问 npm 解析安装器。需要完全离线时,先将安装器固定在本地依赖中,或通过已安装的 CLI 执行:
39
+ 克隆仓库后,在仓库根目录运行即可亲自操作两版页面,无构建步骤、无模型调用:
72
40
 
73
41
  ```sh
74
- npm install --save-dev --save-exact apple-design-skill@0.0.1
75
- ./node_modules/.bin/apple-design-skill use 0.0.1 --all
42
+ python3 -m http.server 4177 --bind 127.0.0.1 --directory examples/agent-learning-compare/dist
76
43
  ```
77
44
 
78
- Windows 可运行 `node node_modules/apple-design-skill/bin/apple-design-skill.mjs use 0.0.1 --all`。
45
+ 打开 <http://127.0.0.1:4177/index.html>,可切换并排、单版、桌面和手机预览。示例随 Git 仓库提供。
79
46
 
80
- ### 保护本地修改
47
+ ## 快速开始
81
48
 
82
- - 已存在的非本包目录或有本地修改的安装,默认拒绝覆盖。
83
- - 使用 `--force` 时,原文件先移动到 `.apple-design-skill/backups/`,CLI 会输出路径。
84
- - 同一版本不允许出现不同技能内容;发布内容变化必须使用新版本号。
85
- - 多目标安装先整体检查,再切换目录;切换失败时恢复之前的活动副本。
86
- - 进程被强制终止可能留下锁或事务目录。检查是否仍有安装器运行,再处理 `.apple-design-skill/lock`;保留事务目录中的 `old-*` 恢复文件。
87
- - 安装器拒绝目标路径和缓存中的符号链接,不通过 `--force` 绕过。
49
+ 需要 **Node.js 22+**。在你要使用 Skill 的项目目录中执行:
88
50
 
89
51
  ```sh
90
- npx apple-design-skill@0.0.1 install --all --force
91
- npx apple-design-skill@0.0.1 uninstall --all
92
- ```
93
-
94
- 卸载仅处理本安装器管理的活动副本,保留版本快照和备份。`--project` / `--global`、`--agent`、`--name` 都要与目标安装对应。若要把团队技能提交到 Git,可提交对应工具的技能目录,并忽略项目中的 `.apple-design-skill/` 历史缓存。
52
+ # Codex
53
+ npx apple-design-skill@latest install --agent codex
95
54
 
96
- ## 使用技能
55
+ # Claude Code
56
+ npx apple-design-skill@latest install --agent claude
97
57
 
98
- Codex 可显式调用 `$apple-design-skill`;Claude Code 可调用 `/apple-design-skill`;其他工具使用各自的技能入口。未立即发现时,开启一个新的 Agent 会话。
99
-
100
- ```text
101
- 使用 apple-design-skill 实现这个页面。
102
- 保留现有产品需求和技术栈,特别检查下拉按钮与展开菜单的一致性,
103
- 并验证键盘选择、关闭方式和窄屏布局。
58
+ # Cursor
59
+ npx apple-design-skill@latest install --agent cursor
104
60
  ```
105
61
 
106
- ### Agent 协作
62
+ 选择你使用的工具执行一条即可。需要同时安装给三个工具时使用 `install --all`;先查看目标路径可追加 `--dry-run`。npm 下载本包不会自动写入技能目录,`install` 命令才会执行安装。
63
+
64
+ 安装后,在新会话中给出具体任务:
107
65
 
108
66
  ```text
109
- 使用 apple-design-skill,通过多个 Agent 协作改进这个页面:
110
- 由负责人确定统一视觉变量并整合改动;
111
- 实现者负责分配到的独立组件;
112
- 交互检查者独立验证下拉菜单、焦点和键盘流程。
113
- 请明确各自修改的文件、验收条件和实际完成的检查。
67
+ 使用 apple-design-skill 改进这个页面。
68
+ 保留现有需求和技术栈,统一布局、排版与组件状态。
69
+ 特别检查下拉按钮与展开菜单,并验证键盘选择、关闭方式和窄屏布局。
114
70
  ```
115
71
 
116
- 协作指南在 [references/collaboration.md](skills/apple-design-skill/references/collaboration.md)。仅在用户请求或宿主已授权时分派 Agent;普通小修改直接完成。不假定每个工具都有子 Agent API,也不替用户安装 Agent 运行时。没有可用的并行能力时,按顺序执行并明确说明。
117
-
118
- 包同时包含 `.codex-plugin/plugin.json` 和 `.claude-plugin/plugin.json`,供支持相应插件格式的宿主或市场打包使用。npm CLI 的安装路径是直接技能安装,不会自动注册插件市场;插件市场版本生命周期由对应宿主管理。
72
+ Codex 可显式调用 `$apple-design-skill`,Claude Code 可调用 `/apple-design-skill`。固定版本、用户级安装、重复入口、升级与回退见[安装指南](docs/installation.md)
119
73
 
120
- ## GitHub Actions → npm
74
+ ## 适合哪些任务
121
75
 
122
- - `ci.yml`:在 Linux、macOS、Windows 上,分别使用 Node.js 22 和 24 检查技能、脚本、安装器测试和 npm 包内容。
123
- - `publish.yml`:推送 `v*` 标签时检查标签与包版本一致,测试后打包并通过 npm Trusted Publishing / OIDC 发布;稳定版本使用 `latest`,预发布版本使用 `next`。
124
- - 发布工作流仅获得 `contents: read` 和 `id-token: write`,不使用长期 `NPM_TOKEN`。
125
- - `workflow_dispatch` 只在版本标签 ref 上执行,可以重跑失败的发布。已成功发布的版本不应重复发布。
126
-
127
- 本包已配置可信发布。初始化时发布的 `1.0.0-rc.1` 保留在 `next`;正式版本从 `0.0.1` 开始,使用 `latest`。npm 侧配置如下:
128
-
129
- | 项目 | 值 |
76
+ | 任务 | Skill 关注的结果 |
130
77
  | --- | --- |
131
- | Provider | GitHub Actions |
132
- | Organization/user | `yqstar` |
133
- | Repository | `apple-design-skill` |
134
- | Workflow filename | `publish.yml` |
135
- | Environment | 留空(工作流未使用命名环境) |
136
- | Allowed action | 允许直接 `npm publish` |
78
+ | 制作或改进 Web 界面 | 遵循现有设计系统,统一排版、颜色、间距、圆角及组件状态 |
79
+ | 修复下拉菜单风格不一致 | 同时检查按钮和展开面板,以及选中、活动、禁用和定位状态 |
80
+ | 审查界面与交互 | 给出问题位置、触发条件、影响和可验证的修正建议 |
81
+ | 实现拖拽、滑动或弹簧动效 | 直接跟手、速度衔接、可中断动画与正确的最终状态 |
137
82
 
138
- 参考 [npm Trusted Publishing](https://docs.npmjs.com/trusted-publishers/);只有工作流文件、仓库和 npm 侧授权同时匹配,OIDC 发布才会成功。
83
+ 技能正文见 [SKILL.md](skills/apple-design-skill/SKILL.md)。普通静态布局无需引入手势实现;玻璃、模糊和弹跳都是可选设计手段。
139
84
 
140
- 后续发版:
85
+ 这是基于 Apple 设计资料的 Web 实践指南,不是 Apple 官方规范或官方产品。技能提供工作指引,无运行时依赖;使用宿主工具现有的模型与权限,不附带模型服务或 API。
141
86
 
142
- ```sh
143
- node scripts/version.mjs 0.0.2
144
- # 更新 CHANGELOG.md,审查改动
145
- npm run check
146
- npm test
147
- git add package.json package-lock.json .codex-plugin/plugin.json .claude-plugin/plugin.json CHANGELOG.md
148
- git commit -m "Release 0.0.2"
149
- git tag v0.0.2
150
- git push origin main
151
- git push origin v0.0.2
87
+ ## 项目组织
88
+
89
+ ```text
90
+ skills/apple-design-skill/ # 唯一的可安装技能源与宿主元数据
91
+ bin/ # npm CLI 入口
92
+ lib/ # 安装、版本缓存、回退与卸载
93
+ examples/agent-learning-compare/
94
+ dist/ # 可直接运行的 A/B 页面与共用资源
95
+ screenshots/ # 桌面、手机与展开菜单的最终截图
96
+ docs/ # 安装、发布与项目组织参考
97
+ scripts/ # 校验与版本维护
98
+ tests/ # 安装器及 npm 包测试
99
+ .github/workflows/ # 跨平台 CI 与 npm 发布
100
+ .codex-plugin/ # Codex 插件清单
101
+ .claude-plugin/ # Claude Code 插件清单
152
102
  ```
153
103
 
154
- ## 本地开发
104
+ 技能源与安装器分别维护;展示页面和截图留在 `examples/`,不进入 npm 安装包或宿主技能目录。插件清单供兼容宿主使用,npm CLI 直接安装 Skill,不自动注册插件市场。
105
+
106
+ ## 开发与贡献
155
107
 
156
108
  ```sh
157
109
  npm ci --ignore-scripts
158
110
  npm run check
111
+ npm run check:example
159
112
  npm test
160
113
  npm pack --dry-run
161
114
  ```
162
115
 
163
- 零运行时依赖。测试使用临时目录,覆盖多 Agent 目标、升级与回退、并存名称、缓存完整性、本地修改保护、备份、可恢复卸载、路径与符号链接检查、事务失败恢复,以及真实 npm 压缩包的安装。
116
+ 欢迎提供可复现的设计问题、交互缺陷与文档改进。[贡献指南](CONTRIBUTING.md)说明修改位置及验证要求;[发布指南](docs/releasing.md)说明版本同步和 GitHub Actions npm 流程;[项目组织参考](docs/project-references.md)记录本次参考的高星 Skill 仓库及采用的做法。
164
117
 
165
118
  ## 来源与许可证
166
119
 
167
- MITCopyright 2026 yqstar。原有设计指导保留在 [SKILL.md](skills/apple-design-skill/SKILL.md),其中链接到 Apple、W3C、MDN 等参考资料;这些第三方资料的权利仍属于原权利人。本包不包含 Apple 品牌图形或官方授权声明。
120
+ [MIT](LICENSE) · Copyright 2026 yqstar。设计指导引用的 Apple、W3C、MDN 等资料见 [SKILL.md 的 Sources](skills/apple-design-skill/SKILL.md#sources),第三方资料的权利仍属于原权利人。
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "apple-design-skill",
3
- "version": "0.0.1",
4
- "description": "Apple-style interface design skills for Codex, Claude Code, Cursor and Agent Skills hosts, with collaboration guidance and versioned installation.",
3
+ "version": "0.0.2",
4
+ "description": "Apple-style interface design skills for Codex, Claude Code, Cursor and Agent Skills hosts, with versioned installation.",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "apple-design-skill": "bin/apple-design-skill.mjs"
@@ -18,6 +18,7 @@
18
18
  ],
19
19
  "scripts": {
20
20
  "check": "node scripts/check.mjs",
21
+ "check:example": "node scripts/check-example.mjs",
21
22
  "test": "node --test tests/*.test.mjs",
22
23
  "prepack": "npm run check",
23
24
  "release:check": "node scripts/release-check.mjs"
@@ -41,7 +42,6 @@
41
42
  "codex",
42
43
  "claude-code",
43
44
  "cursor",
44
- "multi-agent",
45
45
  "accessibility"
46
46
  ],
47
47
  "publishConfig": {
@@ -7,11 +7,9 @@ description: "Design, implement, and review Apple-style web interfaces, with par
7
7
 
8
8
  Build responsive, coherent interfaces using the project's design system. User requirements take precedence over stylistic defaults. This is web adaptation guidance informed by Apple resources, not an official Apple specification. Instructions are consolidated here; apply the sections relevant to the task.
9
9
 
10
- ## Agent hosts and collaboration
10
+ ## Agent hosts
11
11
 
12
- These instructions are portable across Agent Skills hosts, including Codex, Claude Code and Cursor. Use the host's available tools and the project's existing stack; references to browser inspection or delegation describe capabilities, not mandatory vendor-specific APIs. If a required verification capability is unavailable, say what remains unverified instead of inventing evidence.
13
-
14
- For user-requested or otherwise authorized multi-agent work, read [Collaboration](references/collaboration.md). Keep a single design owner, assign independent work with explicit file boundaries, and review the integrated result. Do ordinary focused tasks directly; this skill does not itself authorize spawning agents, installing software, publishing, or changing external services.
12
+ These instructions are portable across Agent Skills hosts, including Codex, Claude Code and Cursor. Use the host's available tools and the project's existing stack; references to browser inspection describe capabilities, not mandatory vendor-specific APIs. If a required verification capability is unavailable, say what remains unverified instead of inventing evidence.
15
13
 
16
14
  **Dropdown priority:** When dropdown appearance is in scope, style and verify both the closed control and the expanded menu. A polished trigger with a mismatched or unverified popup is incomplete. Keep this requirement when refining or shortening this skill.
17
15
 
@@ -1,38 +0,0 @@
1
- # Coordinating design work across agents
2
-
3
- Read this when the user requests a team or parallel work, or when the host's applicable instructions already authorize delegation. This reference does not grant permission to spawn agents or to change external systems. A small edit normally needs one agent.
4
-
5
- ## Choose independent work
6
-
7
- Use the host's actual delegation mechanism. Do not invent tool names, emulate independent reviewers inside one conversation, or launch paid model requests merely because a role is listed here. If delegation is unavailable, do the work sequentially and disclose that limitation. Do not assume one provider's models, tools or effort settings exist on another host.
8
-
9
- Useful bounded roles:
10
-
11
- - **Design owner:** resolves the user's task, freezes shared visual tokens and the interaction contract, assigns file ownership, integrates changes, and owns the final result.
12
- - **Implementer:** works on a named route or component using the supplied tokens and primitives. Receives an exclusive file list or isolated branch; returns code and the states it checked.
13
- - **Interaction reviewer:** reads the relevant implementation and tests a concrete user journey without editing shared source. For dropdowns, checks the closed and expanded appearance, selected versus active state, keyboard behavior, dismissal and real committed value. For gestures, uses only the relevant motion checks from SKILL.md.
14
-
15
- Do not assign multiple agents to edit the same stylesheet, token file or shared component. Have the owner establish those files first, or assign them to one implementer. Parallelize independent components or read-only reviews. If a prerequisite is still undecided, resolve it before dependent implementation.
16
-
17
- ## Handoff contract
18
-
19
- Each assignment should state only what the agent needs:
20
-
21
- ```text
22
- User goal and agreed scope:
23
- Task and acceptance criteria:
24
- Relevant skill sections and references:
25
- Existing components / tokens / allowed files:
26
- Constraints and authorization boundaries:
27
- Required evidence and return format:
28
- ```
29
-
30
- Provide the same product requirements to implementers. Give reviewers the user's requirements and current artifact, not a desired verdict or presumed bug. If requesting a skill/no-skill comparison, use isolated contexts where possible and disclose any shared context; don't label a review independent if it inherited the proposed answer.
31
-
32
- Return file paths, changed behavior, checks actually performed, and unresolved issues. Keep screenshot evidence of expanded dropdowns when that UI changed. Distinguish screenshots from interaction evidence and real devices from viewport simulation.
33
-
34
- ## Integration
35
-
36
- The owner reviews diffs, resolves token and ownership conflicts, then checks the integrated journey. A component passing alone does not prove that placement inside a dialog, iframe or narrow viewport works. Review the specific finding before applying a repair; don't merge conflicting suggestions mechanically.
37
-
38
- Stop spawning agents when useful independent work is exhausted. Cancel obsolete assignments after scope changes. Keep one owner for deployment, release, messages, and other external side effects; delegation does not expand the user's authorization. Report which work was parallel, what was integrated, and any remaining verification gaps.