jig-ui 0.21.0 → 0.23.0

package/examples/G-161.html

@@ -0,0 +1,7 @@
+<!-- G-161 · A layout change that jumps -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:6px;"><p style="margin:0;font-size:12px;color:#57534e;">Row 2 deleted. In the next frame:</p><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">Pay the invoice</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">Book the venue</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">Send the agenda</div><p style="margin:0;font-size:12px;color:#57534e;">The rows below snapped up. Nothing shows what went where.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:6px;"><p style="margin:0;font-size:12px;color:#57534e;">Row 2 deleted. Over the next 150ms:</p><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">Pay the invoice</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;box-shadow:0 0 0 2px #a8a29e;">Book the venue ↑</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;box-shadow:0 0 0 2px #a8a29e;">Send the agenda ↑</div><p style="margin:0;font-size:12px;color:#57534e;">The rows below slide up into the gap, so the eye follows them.</p></div></div>
+</figure>

package/examples/G-162.html

@@ -0,0 +1,18 @@
+<!-- G-162 · Animating layout, or everything -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:6px;"><pre style="margin:0;font-family:ui-monospace,Menlo,monospace;font-size:12px;background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:8px;white-space:pre-wrap;">.panel {
+  transition: all 200ms;
+}
+.row {
+  transition: height 200ms;
+}</pre></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:6px;"><pre style="margin:0;font-family:ui-monospace,Menlo,monospace;font-size:12px;background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:8px;white-space:pre-wrap;">.panel {
+  transition: opacity 150ms var(--ease-out),
+    transform 150ms var(--ease-out);
+}
+.row {
+  transition: transform 150ms var(--ease-in-out);
+}</pre></div></div>
+</figure>

package/examples/G-163.html

@@ -0,0 +1,7 @@
+<!-- G-163 · Several things moving at once -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:6px;"><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">Gradient drifting behind the hero</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">Scroll arrow bouncing</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">Logo ticker scrolling</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">"New" badge pulsing</div><p style="margin:0;font-size:12px;color:#57534e;">Four loops at once. The saved message arrives and nobody sees it.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:6px;"><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">Hero, still</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">Scroll arrow, still</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;">Logo row, still</div><div style="background:#fff;border:1px solid #d6d3d1;border-radius:4px;padding:6px 10px;font-size:13px;box-shadow:0 0 0 2px #a8a29e;">Saved ✓</div><p style="margin:0;font-size:12px;color:#57534e;">One thing moves: the message the user caused.</p></div></div>
+</figure>

package/examples/I-148.html

@@ -0,0 +1,7 @@
+<!-- I-148 · A claim with no source -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">Teams using Acme ship 37% faster.</p><p style="margin:0;font-size:14px;">A 2024 study found developers save 11 hours a week.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">In our own use, releases went from weekly to twice a week.</p><p style="margin:0;font-size:12px;color:#57534e;">Source: our release log, January to June 2026</p></div></div>
+</figure>

package/examples/I-149.html

@@ -0,0 +1,7 @@
+<!-- I-149 · Specific in sound, empty in fact -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">Organisations that adopt these practices often see significant gains in efficiency.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">The billing team closed March in two days instead of five.</p></div></div>
+</figure>

package/examples/I-150.html

@@ -0,0 +1,7 @@
+<!-- I-150 · Formula openers, closers and signposts -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">In today's rapidly changing world, it is important to note that backups matter.</p><p style="margin:0;font-size:14px;">In conclusion, only time will tell.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">Back up before you migrate.</p><p style="margin:0;font-size:14px;">A failed migration cannot be undone.</p></div></div>
+</figure>

package/examples/I-151.html

@@ -0,0 +1,7 @@
+<!-- I-151 · Saying it twice -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">Jig checks a page before it ships.</p><p style="margin:0;font-size:14px;">It reads the rules and applies them.</p><p style="margin:0;font-size:14px;">In short, Jig makes sure every page is checked before shipping.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">Jig checks a page before it ships.</p><p style="margin:0;font-size:14px;">It reads the rules and applies them.</p><p style="margin:0;font-size:14px;">A machine decides 39 of them; a reviewer judges the rest.</p></div></div>
+</figure>

package/examples/I-152.html

@@ -0,0 +1,7 @@
+<!-- I-152 · A rhetorical shape on repeat -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">It's not a tool, it's a workflow.</p><p style="margin:0;font-size:14px;">It's not a checklist, it's a habit.</p><p style="margin:0;font-size:14px;">It's not a rule, it's a promise.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">It runs in your editor.</p><p style="margin:0;font-size:14px;">Before you ship, it checks each page and names the rule a line breaks.</p></div></div>
+</figure>

package/examples/I-153.html

@@ -0,0 +1,7 @@
+<!-- I-153 · Enthusiasm the content has not earned -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">An incredibly exciting, truly transformative update. The possibilities are endless.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">Exports now include every column, so the monthly report takes one download instead of four.</p></div></div>
+</figure>

package/examples/I-154.html

@@ -0,0 +1,7 @@
+<!-- I-154 · Stacked hedges -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">It may potentially suggest that this could, in some cases, help.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">The evidence suggests it helps on pages over 2,000 words.</p></div></div>
+</figure>

package/examples/I-155.html

@@ -0,0 +1,7 @@
+<!-- I-155 · Emoji in headings -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><div style="font-size:16px;font-weight:700;line-height:1.2;">🚀 Getting started</div><p style="margin:0;font-size:14px;">Install it with one command.</p><div style="font-size:16px;font-weight:700;line-height:1.2;">✨ Key features</div><p style="margin:0;font-size:14px;">It checks each page before you ship.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><div style="font-size:16px;font-weight:700;line-height:1.2;">Install Jig in one command</div><p style="margin:0;font-size:14px;">Install it with one command.</p><div style="font-size:16px;font-weight:700;line-height:1.2;">What each check reports</div><p style="margin:0;font-size:14px;">It checks each page before you ship.</p></div></div>
+</figure>

package/examples/I-156.html

@@ -0,0 +1,7 @@
+<!-- I-156 · Structure imposed rather than earned -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><div style="font-size:14px;font-weight:700;line-height:1.2;">Overview</div><p style="margin:0;font-size:14px;">Jig checks pages.</p><div style="font-size:14px;font-weight:700;line-height:1.2;">Key benefits</div><p style="margin:0;font-size:14px;">It is fast.</p><div style="font-size:14px;font-weight:700;line-height:1.2;">Conclusion</div><p style="margin:0;font-size:14px;">Jig checks pages.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><div style="font-size:14px;font-weight:700;line-height:1.2;">Install Jig in one command</div><p style="margin:0;font-size:14px;">Run npx jig-ui init in your project.</p><div style="font-size:14px;font-weight:700;line-height:1.2;">Run your first check</div><p style="margin:0;font-size:14px;">Run npx jig-ui check. Each finding names its rule.</p></div></div>
+</figure>

package/examples/I-157.html

@@ -0,0 +1,7 @@
+<!-- I-157 · Nothing only the author could say -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">The migration was challenging, but the team learned valuable lessons.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">The migration looked like a weekend's work. It took three weeks, because two services wrote the same table and nobody had written that down.</p></div></div>
+</figure>

package/examples/I-158.html

@@ -0,0 +1,7 @@
+<!-- I-158 · No point of view -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">There are several factors to consider, each with its own trade-offs.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">The technology was not the hard part. Changing how procurement worked was.</p></div></div>
+</figure>

package/examples/I-159.html

@@ -0,0 +1,7 @@
+<!-- I-159 · An even rhythm -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">We started the project in May. We chose a small team for it. We wrote the plan in one week. We shipped the first page in June. We learned a lot along the way.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">We started in May with three people. The plan took a week. The first page took six, because nobody had asked support what customers searched for.</p></div></div>
+</figure>

package/examples/I-160.html

@@ -0,0 +1,7 @@
+<!-- I-160 · Feeling named, not shown -->
+<figure data-example="dont">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">I was fascinated by the results, which provided valuable insights.</p></div></div>
+</figure>
+<figure data-example="do">
+  <div style="font-family:system-ui,-apple-system,'Segoe UI',sans-serif;font-size:13px;line-height:1.45;color:#1f1f1f;background:#f5f5f4;padding:16px;min-height:176px;box-sizing:border-box;"><div style="display:flex;flex-direction:column;gap:8px;"><p style="margin:0;font-size:14px;">I did not expect the result. We had tested it three times, and it failed in exactly the same place.</p></div></div>
+</figure>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jig-ui",
-  "version": "0.21.0",
-  "description": "A design system for coding agents. 143 numbered UI rules, brand x mode design tokens, and an installer for Claude Code, Codex, Cursor and opencode.",
+  "version": "0.23.0",
+  "description": "A design system for coding agents. 159 numbered UI rules, brand x mode design tokens, and an installer for Claude Code, Codex, Cursor and opencode.",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {

package/rules/00-anti-patterns.md

@@ -590,6 +590,25 @@ A pulse says "look here, something is happening". On a status that has not chang
 
 **Scope: this is about motion that answers an input or carries a state change.** It is not a ceiling on every animation on the page. Slow decorative looping motion — see `P-13` — runs for seconds by design, and is not covered here. The reason the two differ is the reason the numbers differ: interaction motion sits between the user and their task, so it must get out of the way; ambient motion is never in the way, so speed would only make it noticeable.
 
+### G-161 A layout change that jumps
+❌ A row deleted, and the rows below snap up into the gap in one frame. A filter applied, and the grid reshuffles with nothing to follow. A card opened into its detail view, with nothing connecting the two.
+✅ When the user's own action moves things, show where they went. The rows below slide up into the gap. Items that stay keep their identity and move to their new place; items that go fade out where they stood. A card grows into its detail view (`view-transition-name` on both, where the browser has View Transitions). Moves within the screen take `--ease-in-out` and `--duration-base`; a whole view changing, `--duration-slow`.
+A jump makes the user find their place again, and they cannot tell a row that moved from a row that changed. The move answers "where did it go?" before they have to ask.
+**Keep it instant** when the user did not cause the change: a live table updating under someone's pointer must not slide the row they were about to click. Also when most of the view changes at once, since a cut is clearer than twenty moves. Under reduced motion the change is instant, and focus or a live region says where things went (`G-43`).
+Technique, for a layout change CSS cannot transition: record each item's position before the change, apply it, then animate each item's `transform` from the old position to zero (first, last, invert, play). Never animate the layout properties themselves (`G-162`).
+
+### G-162 Animating layout, or everything
+❌ `transition: height 200ms`, `transition: all 150ms`, a keyframe that moves `top` or `margin-left`, Tailwind's `transition-all`
+✅ Animate `transform` and `opacity`. To move, `translate`; to grow, `scale` or a clip; to appear, `opacity`. Name the properties a transition covers: `transition: opacity var(--duration-fast) var(--ease-out), transform var(--duration-fast) var(--ease-out)`.
+`width`, `height`, `margin`, `padding`, `top`, `left` and their kin change layout, so the browser works out the position of everything around the element again on every frame, and on a slow phone the motion stutters. `transform` and `opacity` do not move anything else. `all` animates every property that changes, including a layout one someone adds next month, and nobody reading the rule can tell which.
+**One accepted case:** a disclosure opening to its content's height (`P-11`). Animate `grid-template-rows` from `0fr` to `1fr` on a wrapper, which the detector does not flag, or write the `height` transition with `<!-- jig-allow G-162: a disclosure grows to its content -->`.
+The detector warns on `transition` or `transition-property` naming `all` or a layout property; a keyframe step setting one; Tailwind's `transition-all` and `transition-[<layout property>]`. `P-13`'s "Animate `transform` and `opacity`" becomes a pointer here.
+
+### G-163 Several things moving at once
+❌ A hero with a drifting gradient, a bouncing scroll arrow, a logo ticker and a pulsing "New" badge, all running together.
+✅ At a time, one thing moves: the one the user caused, or the one they need to notice now. Things that move as one count as one: a list reordering, `P-13`'s ambient layers on one surface.
+Motion is the strongest pull on the eye a page has. Two things moving split it; four make the page restless, and the one that matters (a saved state, an error arriving) competes with decoration and loses. `G-145` is the one-dot case of this rule.
+
 ---
 
 ## H. Code-level

package/rules/01-modes.md

@@ -190,7 +190,7 @@ Attempting to vary these by mode is a category error:
 - **Accessibility floors.** Contrast, focus indication, target size, semantic markup. Identical in all three. `operator` being dense does not license a 24px tap target or a 3:1 body contrast.
 - **Brand identity.** Palette, typeface, logo, voice.
 - **State completeness.** Every mode renders loading, empty, error and disabled.
-- **The anti-pattern file.** All 125 rules in it apply everywhere.
+- **The anti-pattern file.** All 128 rules in it apply everywhere.
 
 ---
 

package/rules/02-tokens.md

@@ -243,6 +243,9 @@ away. That maps onto the tokens:
   the closer analogue, and we do not ship one: exits in this system fade or
   collapse in place rather than fly off screen, and a third easing token bought
   only that one case.
+- **Moving within the screen**, from one place to another: `--ease-in-out`. The
+  element is on screen at the start and the end, so it speeds up leaving its
+  place and slows into the new one (`G-161`).
 - **Never linear** for anything that moves. Linear reads as mechanical because
   nothing physical moves that way. Colour and opacity are the exception — a
   simple curve is enough there, and often linear is fine.

package/rules/03-patterns.md

@@ -429,7 +429,8 @@ it that they did not cause. Motion in those modes always means something changed
 - **Animate `transform` and `opacity`.** These run on the compositor. A loop that
   runs forever on every frame the page is open cannot afford animated `blur`,
   `box-shadow`, or anything that triggers layout — the cost is not paid once, it is
-  paid continuously, on whatever device the reader has.
+  paid continuously, on whatever device the reader has. `G-162` holds this for all motion;
+  here the cost is simply paid forever.
 
 **Anti-pattern:** ambient motion used to direct attention. It is atmosphere, not a
 signal. The moment it points at something it has become interaction motion badly

package/rules/05-copy.md

@@ -1,8 +1,8 @@
 # 05 · Copy
 
 **Status:** draft v0.1
-**Scope:** universal. Interface text in every mode.
-**Load when:** writing or reviewing any user-facing string — labels, buttons, headings, errors, empty states, help text.
+**Scope:** universal. Interface text in every mode, and the prose a page ships: docs, guides, marketing pages, blog posts.
+**Load when:** writing or reviewing any user-facing string — labels, buttons, headings, errors, empty states, help text — or any prose longer than a paragraph.
 
 Interface text is interface design. A screen with perfect spacing and a vague button label is a broken screen. Most of what follows costs nothing to apply and is invisible when done well.
 
@@ -142,6 +142,89 @@ See `P-01` for *where* the message goes and `F-37` for field-level validation te
 
 ---
 
+## Prose
+
+**Scope:** prose longer than a paragraph that a page ships: docs, guides,
+marketing pages, and everything under *Long-form* below. Interface strings stay
+under the rules above; `I-79`'s 20-word sentence limit is for them, not for
+prose. A page with no prose longer than a paragraph judges these `n/a`.
+
+These rules judge whether prose is specific, sourced and authored. They never
+judge who wrote it: a finding says the copy reads as generic, never that a
+model wrote it.
+
+### I-148 A claim with no source
+❌ "Teams using Acme ship 37% faster." "A 2024 Stanford study found…" A feature described that the product does not have.
+✅ Every figure, study, quotation, date and feature a page states traces to something in the project: its data, its docs, a link to the source, the product itself. Otherwise it is cut, or written as what it is: "in our own use", "we expect".
+A made-up figure reads exactly like a real one, and it is the claim a reader is most likely to repeat. Of everything here, it costs the most when it is wrong.
+
+### I-149 Specific in sound, empty in fact
+❌ "Organisations that adopt these practices often see significant gains in efficiency."
+✅ Name who, how many, how much, compared with what. "The billing team closed the month in two days instead of five."
+The test, as `I-81` has it for headlines: if the sentence would still be true after swapping in any other product, team or year, it says nothing.
+
+### I-150 Formula openers, closers and signposts
+❌ "In today's rapidly changing world…" "It is important to note that…" "Let's dive in." "Here's the thing:" "In conclusion…" "Only time will tell."
+✅ Start with the point; end when it has been made. Signpost only where a reader would otherwise be lost.
+`check` warns on a short, fixed list of phrases that are almost never needed; the judgment half covers the same habit in other words. A quotation keeps its own words, as with `I-118`.
+
+### I-151 Saying it twice
+❌ A conclusion that restates the introduction. A lead sentence repeated as the next section's opening. The same point made again in new words two paragraphs later.
+✅ Each paragraph adds something. Where a reader needs a reminder, point back to where it was said.
+
+### I-152 A rhetorical shape on repeat
+❌ "It's not X, it's Y" in every section; three adjectives, three verbs, three clauses, sentence after sentence; every paragraph built claim, example, takeaway.
+✅ Any one of these is fine. The finding is density: the same shape often enough that a reader starts to hear it.
+
+### I-153 Enthusiasm the content has not earned
+❌ "An incredibly exciting, truly transformative opportunity." "The possibilities are endless."
+✅ Let the thing described make the case. If it is impressive, the specifics show it; if they do not, the adjectives will not.
+
+### I-154 Stacked hedges
+❌ "It may potentially suggest that this could, in some cases, help."
+✅ One qualifier, where the uncertainty is real: "The evidence suggests…"
+Exception: legal, medical and scientific text, and any claim that is genuinely uncertain, may need more.
+
+### I-155 Emoji in headings
+❌ "🚀 Getting started", "✨ Key features"
+✅ The words carry the heading. An emoji is read aloud by a screen reader as its name, and at the head of every section it reads as a template.
+In markup, `A-05` already reports every emoji, a heading's included; `check` reports this rule for a Markdown page's headings, which `A-05` does not read.
+
+### I-156 Structure imposed rather than earned
+❌ Overview, Key benefits, Challenges, Best practices, Conclusion, whatever the subject. A heading every two paragraphs. Every bullet opening with a bold phrase. A numbered list for things with no order.
+✅ Let the content decide the structure: a heading where a reader would look for one, a numbered list for a sequence, bold only where a reader scanning must stop.
+
+---
+
+## Long-form
+
+**Scope:** authored writing a person puts their name to: blog posts, essays,
+case studies, release notes written as a story. Everything under *Prose* applies
+as well. Judged by a reader, never measured: rhythm and voice have no number a
+check could hold, and a score would reward prose that games it.
+
+### I-157 Nothing only the author could say
+❌ "The migration was challenging, but the team learned valuable lessons."
+✅ "The migration looked like a weekend's work. It took three weeks, because two services wrote the same table and nobody had written that down."
+A post worth reading holds something the reader could not have written themselves: a case, a number, a mistake, a decision and its reason.
+
+### I-158 No point of view
+❌ "There are several factors to consider, each with its own trade-offs."
+✅ Say which factor mattered, and why: "The technology was not the hard part. Changing how procurement worked was."
+Balance is fine when the question is open. A post that never commits to anything has not said what its author thinks.
+
+### I-159 An even rhythm
+❌ Sentence after sentence of the same length and build; paragraphs of identical size down the page.
+✅ Short sentences where something lands, longer ones where an idea needs room. Read it aloud: an even rhythm is audible long before it is visible.
+Not a length rule, and not a count: `I-79`'s limit is for interface strings.
+
+### I-160 Feeling named, not shown
+❌ "I was fascinated by the results, which provided valuable insights."
+✅ "I did not expect the result. We had tested it three times, and it failed in exactly the same place."
+Where a post reports a reaction, the specifics carry it; a named emotion with nothing behind it reads as flat.
+
+---
+
 ## L-06 · Copy checklist
 
 1. Sentence case throughout? (`I-53`)
@@ -152,3 +235,6 @@ See `P-01` for *where* the message goes and `F-37` for field-level validation te
 6. Numerals as figures, formatted consistently? (`I-83`)
 7. One word per concept across the whole product? (`I-87`)
 8. Every error saying what happened and what to do next? (`I-90`)
+9. Every figure, study, quotation and feature traceable to a source? (`I-148`)
+10. Prose saying something specific, once, without formula? (`I-149`, `I-150`, `I-151`)
+11. For long-form: something only the author could say, and a view? (`I-157`, `I-158`)

package/rules.index.json

@@ -1013,5 +1013,119 @@
     "severity": "warning",
     "since": "0.17.0",
     "pass": "screen"
+  },
+  {
+    "id": "I-148",
+    "bucket": "judgment",
+    "severity": "warning",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "I-149",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "I-150",
+    "bucket": "hybrid",
+    "severity": "warning",
+    "since": "0.23.0",
+    "detector": "formula-phrase",
+    "pass": "code"
+  },
+  {
+    "id": "I-151",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "I-152",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "I-153",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "I-154",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "I-155",
+    "bucket": "mechanical",
+    "severity": "warning",
+    "since": "0.23.0",
+    "detector": "heading-emoji"
+  },
+  {
+    "id": "I-156",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "I-157",
+    "bucket": "judgment",
+    "severity": "warning",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "I-158",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "I-159",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "I-160",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "G-161",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
+  },
+  {
+    "id": "G-162",
+    "bucket": "hybrid",
+    "severity": "warning",
+    "since": "0.23.0",
+    "detector": "layout-motion",
+    "pass": "code"
+  },
+  {
+    "id": "G-163",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.23.0",
+    "pass": "code"
   }
 ]