Skip to content

Releases

v0.3.4 — the design half gets eyes

Choose a tag to compare

@yannikzz yannikzz released this 27 Oct 07:56
9647695

A generated brand is now checked against what it actually renders, and the health check reports refuted structural directions instead of passing over them. Nothing breaks: the audit script's exit codes are unchanged.

Install

/plugin marketplace add yannikzz/ui-contract
/plugin install ui-contract@yannikzz

No Claude Code marketplace? Download ui-contract-0.3.4.zip below — its README covers both install paths, including install.sh for other agents' skill directories.

What changed since 0.3.3

ui-contract-design — originating a brand (ADR-0017)

  • Tear down real references first. Before the three directions are offered, two or three real products in the category are taken apart and recorded in design.md §1 — what was kept, what was deliberately broken. The look-alike checks now run against those instead of a thought experiment.
  • Vague words get translated. An aesthetic adjective ("cleaner", "more premium") has to become the token group it moves and one observable decision.
  • The tuning session has a close. A fixed visual baseline (the prototype wall, a 480px frame, 200% crops of the two densest controls), a three-second check on it, then one context-free review that reports whether the surface still reads as the chosen direction. The review can be skipped, but a skip is written into §1 rather than left silent.
  • Motion states its basis. §8 values say where they come from — the product's state rhythm, the platform's convention, the signature treatment — or are marked as the weakest section.

ui-contract-audit — the health check

  • Check 10 now lifts refuted (⛔) rows verbatim, separately from pending (⏳) ones. Before, it could not see them at all.
  • The report ends with a machine-readable AUDIT-JSON line: pass / skip / fail for each check, and the warning count. The prose report and the exit codes are unchanged.

Other

  • The ui-contract skill no longer carries a stale version: "0.2.0"; plugin.json is the one version.
  • Development only (not in the zip): CI now runs the same ./testing/run.sh maintainers run locally, and the repository gained a security policy and issue / pull request templates.

中文说明

生成品牌(ui-contract-design):

  • 提出三个方向之前,会先拆解两三个同类的真实产品作为参照。
  • 「更干净」「更高级」这类形容词,必须翻译成具体要动的颜色、间距等设计变量(token),以及一个看得见的决定。
  • 调校收尾时会截一组固定的对照图,做一次「看三秒」检验,再请一个不知道前情的评审者判断:结果还像不像当初选的方向。评审可以跳过,但跳过要写进 design.md。
  • 动效数值必须写明依据。

体检(ui-contract-audit):第 10 项检查现在会把「已被否决的方向(⛔)」原样列出来,以前完全看不到;报告末尾新增一行机器可读的汇总。退出码不变,不影响现有的 CI。

ui-contract-0.3.4.zip · SHA-256 ba8d08fcd4bb877b0d25b27fd20e6f6d3ba347905f48da771b9a756f017a828b

v0.3.3 — frontmatter fix

Choose a tag to compare

@yannikzz yannikzz released this 13 Oct 06:17
43e875c

Fixes three skills that strict YAML parsers refused to load. If you installed 0.3.2 (or 0.3.1), update.

Install

/plugin marketplace add yannikzz/ui-contract
/plugin install ui-contract@yannikzz

No Claude Code marketplace? Download ui-contract-0.3.3.zip below — its README covers both install paths, including install.sh for other agents' skill directories.

What changed since 0.3.2

  • Fixed: the description of ui-contract, ui-contract-design and ui-contract-audit contained an unquoted : , so their frontmatter was not valid YAML. Lenient readers still got the text; strict parsers rejected the file, and GitHub showed mapping values are not allowed in this context. The values are now quoted and read exactly as before. This was present since 0.3.1.
  • The wording of every skill is otherwise unchanged.
  • Development only (not in the zip): a new structural check fails the build when any SKILL.md frontmatter cannot be parsed, so this cannot ship again unnoticed.

中文说明

修复了 3 个技能(ui-contract、ui-contract-design、ui-contract-audit)开头元信息的格式错误:描述里有没加引号的冒号,按严格规则解析的工具会直接拒绝加载这 3 个技能。0.3.1 和 0.3.2 都有这个问题,装过的话请更新。技能内容本身没有变化。仓库里另外新增了一条自动检查,同类错误以后无法再被发布出去。

ui-contract-0.3.3.zip · SHA-256 3ce9f3c6ec62a34c14a7ba172f729a8c081f9fc1cf260300b72b0c98e562f833

v0.3.2 — first public release

Choose a tag to compare

@yannikzz yannikzz released this 11 Oct 07:49
3e2a84d

First public release of ui-contract: 15 skill packages for Claude Code that establish a project's UI contract — a structural spec with a placement decision tree and a region-name allowlist, a visual spec whose values live in the token file, an asset layer, a low-fidelity wireframe, and enforcement that stops coding agents from putting new features in the wrong place.

Install

/plugin marketplace add yannikzz/ui-contract
/plugin install ui-contract@yannikzz

No Claude Code marketplace? Download ui-contract-0.3.2.zip below — its README covers both install paths, including install.sh for other agents' skill directories.

What changed since 0.3.1

  • Licensed under MIT, copyright @yannikzz and @loot20mal. The manifest gains a license field, and the zip now ships LICENSE.
  • The skills themselves are unchanged. If you already have 0.3.1, updating only brings the license.

中文说明

第一个公开版本。和 0.3.1 相比,技能内容没有任何变化,唯一的变化是加上了 MIT 协议:manifest 多了 license 字段,zip 里多了 LICENSE 文件。已经装了 0.3.1 的话,更新后只会多出这份协议。

ui-contract-0.3.2.zip · SHA-256 adef3016cda772b2ac7968751f73b27af04a4202f6efb36a16fd76751c30907c