@letterstory/design 0.2.11 → 0.2.12

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.
Files changed (2) hide show
  1. package/PRINCIPLES.md +11 -0
  2. package/package.json +1 -1
package/PRINCIPLES.md CHANGED
@@ -108,3 +108,14 @@ count (`docs/architecture/plan-strategies.md`); the code keeps the names Plan an
108
108
  finder reads only the patterns, the check reads when it is not a mistake (`lib/recipes/known-issues.ts`). Technical problems a rule can decide (broken or missing
109
109
  structured data, link previews) are rules (`lib/site/observations/`). A "Z is broken" row belongs
110
110
  in Fix's known issues, never in the Plan.
111
+
112
+ ## UI copy
113
+
114
+ Headlines, labels, buttons, nav items and data only (Kaya, 2026-11-09: explainer copy makes people ask "can I just
115
+ give this to my Claude?"). No subtitle under a heading, no helper paragraph, no "what this does" blurb, no option
116
+ description, no tooltip that restates its control. Where a line is truly needed (an empty state, an error the user
117
+ recovers from), one plain sentence, ideally under 8 words. No AI tells: "seamlessly", "effortlessly", "powerful",
118
+ "unlock", "leverage", "supercharge", "in just a few clicks", "Whether you're…", em-dash asides, lists of three
119
+ adjectives, "AI-powered". Model-written text shown in the UI follows the same rule: keep the field for agents, and
120
+ either keep it off the page or tighten its prompt. The words themselves are decided once in
121
+ `docs/architecture/copy-pass.md`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@letterstory/design",
3
- "version": "0.2.11",
3
+ "version": "0.2.12",
4
4
  "description": "Letter design tokens, the phantom theme registry, and the design principles — one source for every Letter repo.",
5
5
  "type": "module",
6
6
  "license": "UNLICENSED",