Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

docs(agents): the dev skill reminds every UI and copy change not to read as AI slop (#904)

Yaowei Zheng8171d2bce618
diff --git a/.agents/skills/penguin-harness-dev/SKILL.md b/.agents/skills/penguin-harness-dev/SKILL.md
index a9b785de..ab1d942b 100644
--- a/.agents/skills/penguin-harness-dev/SKILL.md
+++ b/.agents/skills/penguin-harness-dev/SKILL.md
@@ -1,6 +1,6 @@
---
name: penguin-harness-dev
-description: Use when developing PenguinHarness itself — changing packages/{core,server,web,cli,desktop,landing,docs,skills}, the built-in model catalog, the installers or the release workflow; writing or auditing changelog entries; writing a blog post or capturing release screenshots; running the test suite here or, when asked, on another machine; reading a prompt-cache regression out of the core suites; deciding what to do about data already on disk; or auditing prose that reads like a leaked authoring session. Covers the two-repo symlink layout, the CI-parity verification chain, the record-and-ship contract, where blog media is hosted, and the seams that are intentional.
+description: Use when developing PenguinHarness itself — changing packages/{core,server,web,cli,desktop,landing,docs,skills}, the built-in model catalog, the installers or the release workflow; writing or auditing changelog entries; writing a blog post or capturing release screenshots; running the test suite here or, when asked, on another machine; reading a prompt-cache regression out of the core suites; deciding what to do about data already on disk; auditing prose that reads like a leaked authoring session; or changing anything a user sees or reads — a component, a style, UI strings, docs, landing copy — which must not read as AI slop. Covers the two-repo symlink layout, the CI-parity verification chain, the record-and-ship contract, where blog media is hosted, and the seams that are intentional.
---
# Developing PenguinHarness
@@ -12,7 +12,7 @@ per plugin under the repo root's `plugins/`, with `packages/plugins` as the load
them all. It **consumes** LLM providers through `@prismshadow/agenthub` and implements no provider
clients of its own.
-This page is the part that applies to every change. Four reference files carry the detail, read
+This page is the part that applies to every change. The reference files carry the detail, read
them when the task reaches them:
| Read | When |
@@ -22,6 +22,17 @@ them when the task reaches them:
| `reference/model-catalog.md` | Touching `model-catalog.ts`, pricing, provider groups or glyphs |
| `reference/authoring.md` | Writing a blog post, auditing prose, or proposing a simplification |
| `reference/release.md` | Preparing a release: the branch order, what changes, the announcement, the blog post and its screenshots |
+| `reference/ai-slop.md` | **Every** change a user sees or reads: UI, styles, UI strings, docs, landing, blog, changelog — the rules, the scanner, the catalogue of tells |
+
+## No AI slop — every time something is rendered or written
+
+Whatever you add to the UI or the copy, check it before you call it done: **decide before you
+decorate; one accent, one voice; hierarchy from scale and space; subtract first; specific beats
+punchy; decoration must mean something.** No gradients, glows, emoji, pill spam, cards in cards,
+coloured keywords or "it's not just X — it's Y". Reuse the theme tokens and `lib/tone.ts`; status
+is an icon plus a tooltip; sections are ruled, not boxed. Run
+`node .agents/skills/penguin-harness-dev/reference/ai-slop/scan.mjs <what you touched>` and triage
+every hit. `reference/ai-slop.md` has the repo's own decisions and the full catalogue.
## Repo shape — read before your first edit
diff --git a/.agents/skills/penguin-harness-dev/reference/ai-slop.md b/.agents/skills/penguin-harness-dev/reference/ai-slop.md
new file mode 100644
index 00000000..fdced373
--- /dev/null
+++ b/.agents/skills/penguin-harness-dev/reference/ai-slop.md
@@ -0,0 +1,75 @@
+# No AI slop: the UI and the copy look chosen, not generated
+
+AI slop is the look a generated product falls into when nobody decides anything: every default
+switched on at once — a gradient, a glow, emoji, a pill on every row, a card around every card,
+"it's not just X — it's Y". It reads as designed in a thumbnail and falls apart on a second look.
+The Web App, the landing site, the docs and the Electron shell are all written by agents, which is
+exactly why they drift there; this page is the brake.
+
+It applies to **every** change that renders something or says something to a user: a component,
+a class list, a string in `strings-en.ts` / `strings.ts`, a docs page, a blog post, a changelog
+entry, a PR body.
+
+## The six rules, held on every change
+
+1. **Decide before you decorate.** Every visual choice must be explainable in one sentence. "It
+ looked empty" is not a reason.
+2. **One accent, one voice.** The theme's tokens carry colour; no new hues, no second accent, no
+ gradient.
+3. **Hierarchy from scale and space.** Not from colouring or bolding scattered words, not from
+ swapping fonts.
+4. **Subtract first.** The first move toward better is removing something — a border, a badge, a
+ shadow, a sentence.
+5. **Specific beats punchy.** Copy says the concrete thing: what happened, what to do, with what.
+6. **Decoration must mean something.** An icon, badge, callout or colour is a signal; if it
+ signals nothing, it goes.
+
+## What this repo already decided (these win over any generic rule)
+
+- Status is the icon's tone plus a tooltip / `aria-label` — no textual `[failed]` markers, no red
+ warning prose. Icon-only buttons are flat: no fill at rest or on hover, the glyph deepens.
+- Info and action sections are ruled (a divider, title left, actions right), not boxed in cards.
+ Labels small and grey, values dark and semibold.
+- List rows are one line: logo, name, the library's own pills right after the name, no raw ids
+ (a tooltip at most). A pane is sized to its rows.
+- Dense lists (settings shortcuts, pickers) use small type and no rule under every row; the group
+ heading is the only divider.
+- Colour comes from the theme tokens and the `tone*` helpers (`lib/tone.ts`), which already exist
+ for attention / danger / success — reuse them, never hand-pick a Tailwind hue.
+- zh copy follows the docs typography rules (CJK–Latin spacing, full-width punctuation, zh
+ "Agent"); prose hygiene for anything published is in `authoring.md`.
+
+## How to check a change
+
+Read the diff once as a user would see it, against the six rules and the list above. Then run the
+scanner over what you touched — it is dependency-free Node and never edits anything:
+
+```sh
+node .agents/skills/penguin-harness-dev/reference/ai-slop/scan.mjs packages/web/src
+node .agents/skills/penguin-harness-dev/reference/ai-slop/scan.mjs packages/landing --only=14,15,29
+node .agents/skills/penguin-harness-dev/reference/ai-slop/scan.mjs <dir> --json # for triage
+```
+
+Every hit is a lead, not a verdict: open the file and decide **slop vs. chosen**. A deliberate
+brand element, a logo, the theme's own tokens stay. Pin a hit you confirmed as intentional with
+an id-scoped comment (`deslop-ignore-next-line 06`) so new tells still surface. A new hit in your
+own diff is yours to remove before the PR, or to name in the PR body with the reason it stays.
+
+Do not sweep the codebase on your own: when a scan turns up existing slop outside your change,
+list it in the PR body or tell the user, and fix it only when asked — the diff stays about its
+subject.
+
+## The catalogue
+
+Vendored verbatim from [yetone/kill-ai-slop](https://github.com/yetone/kill-ai-slop) (`skill/`,
+commit `f6e2ae32b304`, Apache-2.0 — `ai-slop/LICENSE`). The three references still say
+`references/` and `scripts/` for their own layout; here they all sit in `ai-slop/`.
+
+| Read | For |
+| --- | --- |
+| `ai-slop/taxonomy.md` | The 35 tells — colour, type, copy, components, motion, layout — what each is, why it reads as machine-made, the fix |
+| `ai-slop/detection.md` | The patterns the scanner greps for, and their common false positives |
+| `ai-slop/fixes.md` | Before → after remediation per tell |
+| `ai-slop/scan.mjs` | The scanner (`--only`, `--skip`, `--exclude`, `--json`) |
+
+To refresh from upstream, copy the same four files over and update the commit above.
diff --git a/.agents/skills/penguin-harness-dev/reference/ai-slop/LICENSE b/.agents/skills/penguin-harness-dev/reference/ai-slop/LICENSE
new file mode 100644
index 00000000..cf0de31d
--- /dev/null
+++ b/.agents/skills/penguin-harness-dev/reference/ai-slop/LICENSE
@@ -0,0 +1,202 @@
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this
+ License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
diff --git a/.agents/skills/penguin-harness-dev/reference/ai-slop/detection.md b/.agents/skills/penguin-harness-dev/reference/ai-slop/detection.md
new file mode 100644
index 00000000..3e57f260
--- /dev/null
+++ b/.agents/skills/penguin-harness-dev/reference/ai-slop/detection.md
@@ -0,0 +1,411 @@
+# Detection patterns
+
+Concrete signals for each tell. `scripts/scan.mjs` encodes these; this file is
+the human reference and the place to widen patterns for a specific stack.
+
+**Scan scope.** Frontend source only: `.html .css .scss .tsx .jsx .ts .js .vue
+.svelte .astro .md .mdx .php .twig` plus `tailwind.config.*`. Skip
+`node_modules dist build .git out .next .astro coverage vendor` and anything
+`*.min.*` or a lockfile.
+
+**Every match is a lead, not a verdict.** Open the file and confirm. The false
+positives noted below are the usual ways a pattern lies.
+
+**Suppression.** Once the user has defended a hit, pin the decision so re-scans
+stay quiet: `--only=` / `--skip=` filter by tell id, `--exclude=` drops paths,
+and comment directives suppress in source — `deslop-ignore` (this line),
+`deslop-ignore-next-line`, `deslop-ignore-file`, each optionally followed by
+tell ids (`/* deslop-ignore-next-line 06 */`). Prefer id-scoped directives so
+other tells still surface on those lines.
+
+**Extension.** `--rules=extra.mjs` loads additional tells (same shape as the
+core ones; string patterns compile case-insensitive). Use it for
+language-specific copy rules — English patterns like tell 14's don't fire on
+non-English slop. `scripts/rules.ru.mjs` is a shipped Russian example. Remember
+JavaScript's `\b` is ASCII-only: it never matches next to Cyrillic and most
+non-Latin scripts, so write plain substrings instead.
+
+---
+
+### 01 Indigo→violet gradient
+```
+rg -n -i 'from-(indigo|violet|purple|fuchsia)-[0-9]+ ?.*to-(purple|violet|fuchsia|pink)-[0-9]+'
+rg -n -i '(linear-gradient|bg-gradient)[^;]*(#6366f1|#8b5cf6|#a855f7|#7c3aed)'
+rg -n -i 'shadow-(purple|violet|indigo)-[0-9]+/[0-9]+'
+```
+*False positives:* a brand that genuinely is purple (check the logo / design
+tokens); a one-off illustration. Slop is the *combination* — purple gradient +
+glow + pill button + "AI-powered" eyebrow.
+
+### 02 Gradient headline text
+```
+rg -n 'bg-clip-text.*text-transparent|text-transparent.*bg-clip-text'
+rg -n '(-webkit-)?background-clip:\s*text'
+rg -n -i '-webkit-text-fill-color:\s*transparent'
+```
+*False positives:* a logo wordmark; a single deliberate hero treatment. Slop is
+gradient text used as the default heading style.
+
+### 03 Warm "cozy" palette
+```
+rg -n -i '\b(amber|orange|stone)-(50|100|200|300)\b'
+rg -n -i 'bg-\[#(fdf6ec|fef3e2|faf3e8|fff7ed|fdf4e3)\]'
+rg -n -i 'text-amber-[0-9]+|border-amber-[0-9]+'
+rg -n -i 'text-(gray|slate|zinc|neutral)-(400|500)[^"]{0,60}bg-(amber|stone|orange|rose|blue|indigo|green)-'
+```
+*False positives:* a food/coffee/craft brand where warm is the identity. Slop is
+warm-as-default with no brand reason. The last pattern is the sibling tell:
+default gray text dropped onto a tinted surface — the gray was never toned to
+the background; use a darker shade of the surface hue instead.
+
+### 04 Default semantic palette
+```
+rg -n -i 'bg-(blue|indigo)-50|bg-amber-50|bg-green-50|bg-emerald-50|bg-red-50'
+rg -n -i 'text-(blue|indigo)-(600|700).*text-(green|emerald)-(600|700)' # multiple stock hues near each other
+rg -n -i 'info.*blue|warning.*amber|success.*green|error.*red'
+```
+*Confirm:* three or four of the stock `-50 / -600` semantic pairs used together
+(info=blue, tip=amber, success=green, error=red), unrelated to the brand. A
+single, deliberate status colour is fine.
+
+### 05 One-hue status box
+```
+rg -n -i 'border-(red|amber|yellow|green|blue)-[0-9]+[^"]*text-\1-[0-9]+'
+rg -n -i 'bg-(red|amber|yellow|green)-[0-9]+/(5|10|15|20)'
+rg -n -i '(error|warning|success)[^\n]{0,40}(red|amber|yellow|green)-[0-9]+'
+```
+*Confirm:* one box where border, text, and a `/10` background are all the same
+hue — the whole alert is one colour at three opacities. A single muted accent on
+a neutral surface is fine.
+
+### 06 Gradients as atmosphere
+```
+rg -n -i 'radial-gradient|bg-\[radial-gradient'
+rg -n -i 'linear-gradient[^;]*(to bottom|180deg|to top)' # top-lighter surface fill
+rg -n -i 'bg-gradient-to-(b|t)\b[\s\S]{0,40}from-'
+rg -n -i 'repeating-(linear|radial)-gradient'
+rg -n -i 'bg-gradient-to-(br|tr|bl|tl)\b[\s\S]{0,40}from-(emerald|green|teal|cyan|purple|violet|fuchsia)-\d+/(5|10|15|20|25)' # per-card accent-hue wash
+rg -n -i 'box-shadow:[^;]*(#(6366f1|8b5cf6|a855f7|22d3ee|06b6d4)|rgba?\(139|rgba?\(168)' # colored glow accents
+```
+*Confirm:* a page-wide radial glow behind everything, or card surfaces filled
+with a top-to-bottom gradient where a flat colour would do; bento cards each
+washed in a tint of their own accent (green card → green gradient, purple →
+purple); repeating-gradient stripes as surface decoration; colored box-shadow
+glows as dark-mode accents. A gradient that points at something specific is a
+choice, not slop.
+
+### 07 Serif-italic on one word
+Hard to grep purely; look for a serif font family or `<em>/italic` applied
+*inside* an otherwise-sans heading.
+```
+rg -n -i 'font-serif|font-family:\s*(georgia|"?playfair|"?lora|"?cormorant)'
+rg -n '<em>|italic' -g '*.{tsx,jsx,vue,svelte,astro,html}'
+```
+*Confirm:* the italic/serif span sits within an `<h1>/<h2>` whose base font is
+sans.
+
+### 08 Serif where sans belongs
+```
+rg -n -i 'font-family:\s*[^;]*(playfair|cormorant|lora|"?dm serif|"?libre baskerville)'
+rg -n -i "fontFamily.*(Playfair|Cormorant|Lora)"
+rg -n -i 'font-serif[^"]{0,60}(italic|text-[4-9]xl)|(italic|text-[4-9]xl)[^"]{0,60}font-serif'
+```
+*False positives:* an editorial/publishing product that wants serif. Slop is
+display serif as UI/body on a tool or dashboard — or the oversized italic-serif
+hero headline, now the universal AI-startup landing page uniform. Set it roman
+or use a non-serif display face; a genuinely editorial register may keep it.
+
+### 09 Decorative strikes & highlights
+```
+rg -n -i 'line-through' -g '*.{css,scss,tsx,jsx,vue,svelte,astro,html}'
+rg -n '<(mark|s|u|del|strike)[\s>]' -g '*.{md,mdx,html,tsx,jsx,vue,svelte,astro}'
+rg -n -i 'text-decoration:\s*(line-through|underline)'
+```
+*Confirm:* a strike over text that isn't being deleted, an underline that isn't
+a link, a highlighter swipe under a heading — decoration, not annotation. Real
+edits, links, and annotations are fine.
+
+### 10 The kicker above every heading
+```
+rg -n -i 'uppercase[\s\S]{0,40}tracking-(wide|wider|widest)|tracking-(wide|wider|widest)[\s\S]{0,40}uppercase'
+rg -n -i '\b(eyebrow|kicker|overline)\b' -g '*.{css,scss,tsx,jsx,vue,svelte,astro,html}'
+rg -n -i 'text-transform:\s*uppercase[\s\S]{0,80}letter-spacing:\s*0?\.[0-9]+em'
+```
+*Confirm:* the same tracked-caps micro-label above the hero *and* every section
+heading, saying what the heading already says (FEATURES over features). A
+kicker that adds a real dimension — a category, a date, a number in a genuine
+sequence — is an editorial device doing its job.
+
+### 11 Full-sentence display headline
+```
+rg -n 'text-(5|6|7|8|9)xl' -g '*.{tsx,jsx,vue,svelte,astro,html}'
+rg -n -i 'tracking-tighter?\b[\s\S]{0,40}font-(extrabold|black)|font-(extrabold|black)[\s\S]{0,40}tracking-tighter?\b'
+rg -n -i 'font-size:\s*(clamp\([^)]*[4-9](rem|\.[0-9]+rem)|[5-9][0-9]px|[4-9]rem)'
+```
+*Confirm:* a full sentence (10+ words) at display size, usually extrabold with
+crushed tracking, wrapping to 3+ lines. Two or three words at display size is
+what display sizes are for. Crushed tracking on its own is the same tell:
+`letter-spacing` past the point where characters keep their shapes
+(`rg -n -i 'letter-spacing:\s*-0?\.0[5-9]'`).
+
+### 12 Flat type hierarchy
+```
+rg -n '<h[12][^>]*text-(sm|base|lg)\b'
+rg -n -i 'font-size:\s*1[4-8]px' -g '*.css' # then count distinct sizes
+```
+Mostly a visual judgment: open the page and count the sizes actually in use.
+*Confirm:* headings barely bigger than body (steps under ~1.25×), hierarchy
+carried by gray shades instead of size. A deliberately quiet, single-size
+editorial layout with strong spacing is a choice; a dashboard where the page
+title and a table cell match is not.
+
+### 13 Highlighted keywords
+```
+rg -n '<mark' -g '*.{md,mdx,html,tsx,jsx,vue,svelte,astro}'
+rg -n 'text-(primary|indigo|purple|violet)-[0-9]+' -g '*.{tsx,jsx,vue,svelte,astro,html}'
+rg -n -i 'font-semibold|font-bold' -g '*.{md,mdx}'
+```
+*Confirm:* multiple colored/`font-semibold` spans inside one paragraph of body
+copy. One accented phrase is fine.
+
+### 14 AI copywriting voice
+```
+rg -n -i "not just .{1,40}\bit'?s\b|say goodbye to|meet your new|supercharge|unlock the power|in seconds, not"
+rg -n -i '\b(blazing[- ]fast|effortless|seamless|game[- ]changer|next[- ]level)\b'
+rg -n -i '\b(growth|security|process|privacy|productivity|compliance|feature|innovation) theater\b'
+```
+Also flag paragraphs built from three-word sentences ("Fast. Beautiful. Yours."),
+em-dash triplets, and "we killed the X theater" framing — dismissing something
+as *theater* is a recurring generated-copy tic; say plainly what the thing does
+or doesn't do. *False positives:* a genuine quote; a doc that discusses these
+phrases (like this one).
+
+### 15 Emoji everywhere
+```
+rg -n '[\x{1F000}-\x{1FAFF}\x{2600}-\x{27BF}\x{2190}-\x{21FF}\x{2B00}-\x{2BFF}]' -g '*.{md,mdx,html,tsx,jsx,vue,svelte,astro}'
+rg -n -i '(🚀|✨|⚡|🔒|🎉).{0,40}(<|$)' # emoji leading a heading/button/bullet
+```
+*False positives:* emoji inside a code sample being documented; an emoji picker
+feature; user-generated content. Slop is an emoji stuck on *every* heading,
+button, and bullet in your chrome.
+
+### 16 Glowing status dot
+```
+rg -n -i 'animate-ping|animate-pulse'
+rg -n -i 'shadow-(green|emerald|lime)-[0-9]+/[0-9]+|box-shadow:[^;]*(0 0|glow)'
+rg -n -i '(ready|online|live)[\s\S]{0,40}(●|rounded-full)'
+```
+*Confirm:* a status dot with a pulsing halo or coloured glow — usually saturated
+green "● Ready / Online." A small flat dot is fine.
+
+### 17 Rounded card, colored left border
+```
+rg -n -i 'border-l-4 .*rounded|rounded.* border-l-4'
+rg -n -i 'border-left:\s*[0-9]+px .*;.*border-radius|admonition|callout|\bnote-box\b'
+rg -n -i 'border-2\b[\s\S]{0,40}border-(indigo|purple|violet|blue|pink|green)-[0-9]+'
+```
+*Confirm:* stacked callouts used as decoration on plain list items, not one
+semantic aside. The last pattern is the sibling: a thick accent ring around a
+rounded card to make one tier "pop" — the border fights the rounded corners;
+remove the ring or carry the emphasis another way.
+
+### 18 Rounded-square icon tiles
+```
+rg -n -i 'rounded-(lg|xl|2xl) bg-(indigo|purple|blue|green|amber|pink)-(50|100)'
+rg -n -i '(lucide|heroicons|@tabler/icons|react-icons)'
+rg -n -i '\b[wh]-(20|24|28|32)\b[\s\S]{0,40}(<svg|Icon)'
+rg -n '<svg[^>]*(width|height)="(9[6-9]|[1-9][0-9]{2})"'
+```
+*Confirm:* one icon-in-a-tile per feature, in a grid, icons unrelated to
+content — or the same reflex at another size, a giant decorative line icon
+parked in a card as filler.
+
+### 19 Max radius + glassmorphism
+```
+rg -n 'rounded-full' -g '*.{tsx,jsx,vue,svelte,astro,html}'
+rg -n -i 'backdrop-blur|backdrop-filter:\s*blur|bg-white/(5|10|20|30)|bg-black/(5|10|20|30)'
+rg -n -i 'border-radius:\s*(9999px|50%|2rem|24px)'
+```
+*Confirm:* `rounded-full` on cards/inputs (not just avatars/pills); blur used as
+the default surface; radius values that don't agree with each other.
+
+### 20 Oversized drop shadow
+```
+rg -n -i 'box-shadow:[^;{}]*\b([6-9][0-9]|[0-9]{3,})px' # a 60px+ blur/spread
+rg -n -i 'shadow-\[[^\]]*\b([6-9][0-9]|[0-9]{3,})px' # tailwind arbitrary shadow
+rg -n -i 'filter:[^;{}]*drop-shadow\([^)]*\b([6-9][0-9]|[0-9]{3,})px'
+rg -n -i '\bborder\b[\s\S]{0,40}shadow-(xl|2xl)|shadow-(xl|2xl)[\s\S]{0,40}\bborder\b'
+```
+*Confirm:* the shadow's render range is far bigger than the element casting it —
+a small card/icon under a huge, faint, barely-offset blur (a fog, not a drop).
+A genuinely large surface (a modal, a full hero) with a proportionate shadow is
+fine; so is one small, tight elevation shadow. The last pattern is the "ghost
+card" variant: a hairline border *and* a wide diffuse shadow on the same card —
+two separators doing one job; commit to an edge or an elevation.
+
+### 21 Corners that don't nest
+Hard to grep with certainty; flag the same radius token on nested containers.
+```
+rg -n -i 'rounded-(xl|2xl|3xl)' -g '*.{tsx,jsx,vue,svelte,astro,html}' # then check for nesting
+rg -n -i 'border-radius:\s*(1rem|1\.5rem|24px|32px)'
+```
+*Confirm:* an outer box and an inner box carrying the *same* big radius, so the
+corners don't sit concentric. Inner radius should be outer minus the padding; a
+single flat radius scale that already nests correctly is fine.
+
+### 22 Border that dies at the corner
+The break is visual (a stroke on the straight edges, none along the arcs);
+grep for the code that produces it — a radius and a border on different boxes.
+```
+rg -n -i 'rounded-(lg|xl|2xl|3xl)[^"]{0,60}overflow-(hidden|clip)|overflow-(hidden|clip)[^"]{0,60}rounded-(lg|xl|2xl|3xl)' # clipping wrapper: check the child for a border
+rg -n -i 'clip-path:\s*inset\([^)]*round'
+rg -n -i 'border-[trbl]\b[^"]{0,60}rounded-(lg|xl|2xl|3xl)|rounded-(lg|xl|2xl|3xl)[^"]{0,60}border-[trbl]\b'
+```
+*Confirm:* a `rounded overflow-hidden` wrapper whose child carries the 1px
+border/dividers — the square ring is erased at every corner by the clip; a
+`clip-path: inset(… round …)` cutting a border off; or a single-side border
+stopping mid-arc on a rounded box. A border set on the rounded element itself
+wraps the arc and is fine; so are straight dividers between square-cornered
+regions.
+
+### 23 Badge & pill spam
+```
+rg -n -i 'rounded-full .*(bg-(indigo|purple|green|amber|pink)-(50|100|200))'
+rg -n -i '>(\s*[✨🔥🎉🚀]\s*)?(new|beta|hot|popular|pro|coming soon)\s*<'
+```
+*Confirm:* several decorative pills in chrome. A real version tag is fine.
+
+### 24 AI-drawn SVG icons
+Grep finds inline SVG; the judgment is visual.
+```
+rg -n '<svg' -g '*.{tsx,jsx,vue,svelte,astro,html,svg}'
+rg -n -i '<circle[^>]*r="[0-9]' # dot eyes / blob body built from primitives
+rg -n -i '(mascot|blob|logo)\.svg'
+```
+*Confirm:* an inline `<svg>` that's a blob-with-dot-eyes or a cartoon creature
+built from primitive shapes, shipped as the product's mark. A drawn icon set or
+a real designed logo is fine.
+
+### 25 Icon in a tint of itself
+```
+rg -n -i 'bg-(indigo|blue|green|amber|red|purple|pink)-[0-9]+/(5|10|15|20)[\s\S]{0,60}text-\1-'
+rg -n -i 'text-(indigo|blue|green|amber|red|purple|pink)-[0-9]+[\s\S]{0,60}bg-\1-[0-9]+/(5|10|15|20)'
+rg -n -i 'rounded-(md|lg|xl)\s+bg-(indigo|blue|green|amber|red)-[0-9]+/(5|10|15|20)'
+```
+*Confirm:* an icon tile whose translucent background is the same hue as the icon
+inside it — every glyph wrapped in a soft colored square. A deliberate opaque
+button surface is fine.
+
+### 26 The springy hover
+```
+rg -n -i 'hover:(scale-1[01][0-9]|-translate-y-)'
+rg -n '\btransition-all\b'
+rg -n -i 'cubic-bezier\([^)]*,\s*1\.[2-9][0-9]*' # overshoot easing = bounce
+rg -n -i 'animate-bounce|transition:[^;]*\b(width|height|margin|padding)\b'
+```
+*Confirm:* scale/lift/bounce on hover across cards, buttons, and images, and
+`transition-all` as the default. A drawer that springs as it physically slides
+in is motion doing a job; a card that jumps when the cursor grazes it is not.
+Also flag animating layout properties (width/height/margin/padding) — jank on
+top of the decoration.
+
+### 27 The wobbling spinner
+```
+rg -n 'translate\(-50%, ?-50%\)' -g '*.{css,tsx,jsx,vue,svelte,astro,html}'
+rg -n '@keyframes +[a-zA-Z-]*(spin|rotate|load)'
+rg -n -i 'animate-spin'
+rg -n 'transform-origin: *[0-9]'
+```
+*Confirm:* run the page and watch one full revolution — the arc's centre must
+not trace a circle. Code tells: a spin keyframe that sets `transform:
+rotate(…)` on an element centered with `transform: translate(-50%, -50%)` (the
+keyframe replaces the whole property, so the element snaps off-centre and
+orbits); a `transform-origin` that isn't the element's centre; `animate-spin`
+on an emoji or on an SVG whose artwork isn't centred in its viewBox. A
+centered element whose keyframe re-states the translate (`translate(-50%,
+-50%) rotate(360deg)`) is fine.
+
+### 28 The all-caps card grid
+```
+rg -n -i 'grid-cols-3'
+rg -n -i 'uppercase[\s\S]{0,30}(text-xs|tracking-wide|tracking-wider)|text-transform:\s*uppercase'
+rg -n -i 'everything you need|why (you.?ll love|choose|teams)'
+```
+*Confirm:* an ALL-CAPS micro-label + number/icon repeated across interchangeable
+cards — a feature grid or a stat-card grid — points unrelated.
+
+### 29 The invented stat row
+```
+rg -n -i '\b[0-9]+[km]\+'
+rg -n '99\.9%|24/7'
+rg -n -i '(10k|50k|99\.9|24/7)[\s\S]{0,60}(developers|users|teams|uptime|support|countries)'
+```
+*Confirm:* three big round numbers in a row — a `Nk+`, a `99.9%`, a `24/7` —
+with tiny uppercase labels, in the hero or above the fold. A real, odd,
+sourced figure ("1,847 CI runs yesterday") is the fix, not a hit.
+
+### 30 The 01 / 02 / 03 section markers
+```
+rg -n '["'\''>`]0[1-9]["'\''<`]' -g '*.{tsx,jsx,vue,svelte,astro,html}'
+rg -n -i 'text-(7|8|9)xl[\s\S]{0,50}(text-(gray|slate|zinc|neutral)-(100|200)|opacity-(5|10|20))'
+rg -n -i 'step[- ](one|two|three)'
+```
+*Confirm:* giant faint ordinals stapled to *unordered* marketing sections. A
+genuinely ordered sequence — install steps, a changelog, an indexed catalogue —
+has earned its numbers.
+
+### 31 Cards inside cards
+Grep gives leads; the judgment is in the rendered DOM.
+```
+rg -n '<(Card|Panel|Box)[^>]*>\s*<\1' -g '*.{tsx,jsx,vue,svelte}'
+rg -n -i 'rounded[^"]*border[^"]*"[\s\S]{0,120}rounded[^"]*border' -g '*.{tsx,jsx,vue,svelte,astro,html}'
+```
+*Confirm:* three or more nested surfaces each with its own border/radius/shadow
+and shrinking padding. A child that is genuinely a separate object (a preview,
+an embed) may keep its own surface.
+
+### 32 One gap everywhere
+```
+rg -n '(space-y-4|gap-4)[^"'\''`]{0,80}(space-y-4|gap-4)' # the token twice on one line
+rg -n -c 'space-y-4|gap-4' # per-file counts; high = lead
+```
+Mostly a visual judgment: the grep only finds the token, the tell is the
+*absence of any other value*. Count the distinct spacing values in a component;
+one value for both within-group and between-group distances is the tell.
+*Confirm:* a heading equidistant from its own body and from the previous
+section. A deliberate uniform grid (a photo wall, a calendar) is a choice.
+
+### 33 Inter everywhere (evolved)
+```
+rg -n -i 'fonts\.googleapis\.com/css2\?family=(Inter|Space\+Grotesk|Manrope|Plus\+Jakarta)'
+rg -n -i 'font-family:\s*[^;]*("?Inter"?|"?Space Grotesk"?|"?Manrope"?|"?Plus Jakarta Sans"?|"?Geist"?)'
+rg -n 'from ["'\'']next/font/google' -g '*.{ts,tsx,js,jsx}'
+```
+*Confirm:* judgment tell — the faces themselves are good. Slop is the stock
+pairing (Space Grotesk display + Inter body) or Inter-by-default with no sign
+anyone compared alternatives. A team that tried others and landed on Inter made
+a choice; check for any evidence of one (a comment, a brand doc, a deliberate
+fallback stack).
+
+### 34 The tasteful terminal (evolved)
+```
+rg -n -i 'font-mono' -g '*.{tsx,jsx,vue,svelte,astro,html}'
+rg -n -i 'font-family:\s*[^;]*(mono|jetbrains|fira code|ibm plex mono|geist mono)'
+rg -n '[╔╗╚╝║═▓▒░]|\$ [a-z]' -g '*.{tsx,jsx,vue,svelte,astro,html,md}'
+```
+*Confirm:* monospace on non-code UI chrome; ASCII banners as decoration;
+near-black with a single warm accent. This one needs judgment most — it's a
+current default, so weigh whether the terminal metaphor actually serves the
+product.
+
+### 35 The editorial dashboard (evolved)
+```
+rg -n -i '>\s*Good (morning|afternoon|evening),' -g '*.{tsx,jsx,vue,svelte,astro,html}'
+rg -n -i 'font-serif' -g '*.{tsx,jsx,vue,svelte,astro,html}'
+rg -n -i 'font-family:\s*[^;]*(fraunces|canela|tiempos|didot|freight|reckless|newsreader)'
+rg -n -i 'oldstyle-nums|font-variant-numeric:\s*oldstyle'
+```
+*Confirm:* the serif is on app chrome (a dashboard h1, stat-card numerals),
+not on genuinely editorial content; the greeting-as-headline sits on an
+operational surface; the cream + tracked-caps kicker + deep accent kit came
+as a set. A docs site or essay page in a text serif is not this tell.
diff --git a/.agents/skills/penguin-harness-dev/reference/ai-slop/fixes.md b/.agents/skills/penguin-harness-dev/reference/ai-slop/fixes.md
new file mode 100644
index 00000000..6324be5d
--- /dev/null
+++ b/.agents/skills/penguin-harness-dev/reference/ai-slop/fixes.md
@@ -0,0 +1,368 @@
+# Fix patterns
+
+Before→after for each tell. These are *directions*, not find-and-replace rules —
+adapt to the project's tokens and framework. Prefer changing a shared token or
+component once over editing every call site.
+
+General order of operations:
+1. Fix the design tokens / theme first (colors, radius, fonts). Many hits
+ disappear at once.
+2. Then components, then one-off call sites.
+3. Then copy.
+
+---
+
+### 01 Indigo→violet gradient
+```diff
+- class="bg-gradient-to-r from-indigo-500 to-purple-500 shadow-lg shadow-purple-500/50"
++ class="bg-[--accent]" /* one solid, chosen accent */
+```
+If a gradient is truly wanted, make it subtle and directional (a single hue,
+low contrast) and justify it. Drop the colored glow shadow.
+
+### 02 Gradient headline text
+```diff
+- <h1 class="bg-gradient-to-r from-indigo-500 to-pink-500 bg-clip-text text-transparent">
++ <h1 class="text-[--ink]"> /* solid; go bigger/heavier for impact */
+```
+
+### 03 Warm "cozy" palette
+Replace the amber/stone wash with a near-neutral base and keep one warm accent:
+```diff
+- bg-[#fdf6ec] text-amber-900 border-amber-200
++ bg-[--paper] text-[--ink] border-[--rule] /* accent stays for one element */
+```
+Propose the neutral values; let the user confirm before applying globally.
+
+### 04 Default semantic palette
+Replace the framework rainbow with a coherent set derived from your palette:
+neutrals plus at most one or two intentional semantic colours.
+```diff
+- <span class="bg-blue-50 text-blue-700">Info</span>
+- <span class="bg-green-50 text-green-700">Success</span>
+- <span class="bg-amber-50 text-amber-700">Warning</span>
+- <span class="bg-red-50 text-red-700">Error</span>
++ <span class="chip">Info</span> <span class="chip">Warning</span>
++ <span class="chip chip--ok">Success</span> /* one chosen green */
++ <span class="chip chip--danger">Error</span> /* the brand accent */
+```
+
+### 05 One-hue status box
+Carry the state in a word first; drop the border/text/tint all being one hue.
+```diff
+- <div class="border border-red-500 bg-red-500/10 text-red-500 rounded p-3">
+- Something went wrong.
+- </div>
++ <div class="border border-[--rule] bg-[--surface] text-[--ink] rounded p-3">
++ <b>Error</b> — something went wrong. /* one muted accent, on a neutral surface */
++ </div>
+```
+
+### 06 Gradients as atmosphere
+Hold one flat background; build surface depth with a hairline, not a gradient.
+```diff
+- <body class="bg-[radial-gradient(circle_at_top,#1e293b,#020617)]">
+- <div class="rounded-2xl bg-gradient-to-b from-white/10 to-white/0 …">
+- <div class="rounded-2xl bg-gradient-to-br from-emerald-400/15 to-transparent …">
++ <body class="bg-[--bg]"> /* one flat colour, held */
++ <div class="rounded-[--radius] bg-[--card] border border-[--rule]">
++ <div class="rounded-[--radius] bg-[--card] border border-[--rule]">
+```
+If a glow must exist, let it point at one element instead of filling the void.
+
+### 07 Serif-italic on one word
+```diff
+- The editor that <em class="font-serif italic text-indigo-600">actually</em> ships.
++ The editor that <b>ships</b>. /* emphasise by weight/position, one voice */
+```
+
+### 08 Serif where sans belongs
+Swap the display serif for the project's UI sans in the font tokens; keep serif
+only if the product's voice is genuinely editorial (and then use a *text* serif).
+```diff
+- font-family: "Playfair Display", serif;
++ font-family: var(--font-sans);
+```
+For the oversized italic-serif hero: set it roman, or move to a non-serif
+display face — the italic-serif hero is the AI-startup landing page uniform.
+
+### 09 Decorative strikes & highlights
+Remove the strike/underline/highlight used for emphasis; let structure carry it.
+```diff
+- <h1>The <s>old</s> <mark>new</mark> way to <u>ship</u>.</h1>
++ <h1>A faster way to ship.</h1>
+```
+Keep strike-through for a real edit, underline for a link, highlight for a real
+annotation — each only when it does that job.
+
+### 10 The kicker above every heading
+Delete kickers that restate their heading; keep one only where it adds a real
+dimension (a category, a date, a genuine sequence number).
+```diff
+- <p class="text-xs uppercase tracking-widest text-indigo-500">Features</p>
+- <h2>What it does</h2>
++ <h2>What it does</h2> /* scale and space introduce the section */
+```
+
+### 11 Full-sentence display headline
+Compress the point into a few words at display size; move the rest to a
+normal-size subline.
+```diff
+- <h1 class="text-7xl font-extrabold tracking-tight">
+- We help modern teams resolve incidents faster than ever before
+- </h1>
++ <h1 class="text-5xl font-semibold">Pages the right engineer</h1>
++ <p class="text-lg text-[--ink-2]">It maps alerts to code owners and routes
++ each incident to whoever shipped the change.</p>
+```
+After shortening, re-check any `max-width` that was sized for the old headline —
+a stale narrow measure (say `20ch`) will re-wrap your few words onto two lines
+and undo the fix. Verify the rendered result, not just the copy.
+
+### 12 Flat type hierarchy
+Give the scale real steps; let the most important thing be unmistakably bigger.
+```diff
+- <p class="text-[15px] font-semibold">Usage this month</p>
+- <p class="text-sm text-gray-500">API calls: 48,210 (+12% vs May)</p>
++ <p class="text-xs text-[--ink-2]">API calls this month</p>
++ <p class="text-4xl font-semibold tabular-nums">48,210</p>
++ <p class="text-xs text-[--ink-3]">+12% vs May</p>
+```
+Merge sizes that are within a pixel or two; aim for ≥1.25× between steps.
+
+### 13 Highlighted keywords
+```diff
+- Our <span class="text-indigo-600 font-semibold">revolutionary</span> platform helps
+- <span class="text-pink-600 font-semibold">ambitious</span> teams move faster.
++ A project tracker for engineering teams. It updates issues from your commits.
+```
+Let structure carry emphasis; at most one accented phrase.
+
+### 14 AI copywriting voice
+Rewrite for specifics. Delete triads, em-dash drama, and "X theater" framing.
+```diff
+- It's not just an editor — it's a movement. Say goodbye to friction.
++ A code editor. Opens in under a second, ~half the memory of Electron editors.
+- We killed the standup theater.
++ It replaces the daily standup with a three-line summary of yesterday's PRs.
+```
+
+### 15 Emoji everywhere
+Remove emoji from headings, buttons, and bullets; keep one only where it carries
+real information (a status).
+```diff
+- <h2>🚀 Why you'll love it</h2>
++ <h2>Why teams pick it</h2>
+```
+
+### 16 Glowing status dot
+Drop the halo, the pulse, and the glow shadow; a flat dot plus a word is enough.
+```diff
+- <span class="relative flex h-3 w-3">
+- <span class="animate-ping absolute h-full w-full rounded-full bg-green-400 opacity-75"></span>
+- <span class="relative rounded-full h-3 w-3 bg-green-500 shadow-lg shadow-green-500/50"></span>
+- </span> Ready
++ <span class="inline-block h-2 w-2 rounded-full bg-[--ok]"></span> Ready
+```
+
+### 17 Rounded card, colored left border
+Collapse stacked callouts to body text; keep at most one real aside.
+```diff
+- <div class="border-l-4 border-indigo-500 rounded-lg bg-indigo-50 p-4">Note …</div>
+- <div class="border-l-4 border-amber-500 rounded-lg bg-amber-50 p-4">Tip …</div>
++ <p>… the note, inline as normal prose …</p>
++ <aside class="note">Beta: exports may change format before 1.0.</aside>
+```
+
+### 18 Rounded-square icon tiles
+Drop decorative tiles; use a labelled list with real specifics.
+```diff
+- <div class="rounded-xl bg-indigo-100 p-2"><Icon/></div><h3>Fast</h3><p>Very fast.</p>
++ <li><b>Fast</b> — cold start in 180 ms, measured on a 2020 laptop.</li>
+```
+
+### 19 Max radius + glassmorphism
+Pick one small radius token; replace blur panes with solid surfaces.
+```diff
+- class="rounded-full backdrop-blur bg-white/10 border border-white/20"
++ class="rounded-[--radius] bg-[--card] border border-[--rule]"
+```
+
+### 20 Oversized drop shadow
+Shrink the shadow to a real elevation: tight blur, small offset, low opacity,
+never bigger than the element. Often a hairline replaces it outright.
+```diff
+- box-shadow: 0 16px 80px 10px rgba(0,0,0,0.36); /* a room-sized fog */
++ border: 1px solid var(--rule);
++ box-shadow: 0 1px 2px rgba(0,0,0,0.06), 0 4px 10px -6px rgba(0,0,0,0.1);
+```
+Keep it colorless; a tinted glow is not depth. (See tell 01 for the purple
+glow-shadow, tell 16 for the status-dot halo.) Ghost-card variant: if a card
+has both a hairline border and a wide soft shadow, keep one — usually the
+hairline.
+
+### 21 Corners that don't nest
+Compute the inner radius from the outer minus the padding, or don't round the
+inner element at all.
+```diff
+- <div class="rounded-2xl p-3"><div class="rounded-2xl">…</div></div> /* both 16px */
++ <div class="rounded-2xl p-3"><div class="rounded-lg">…</div></div> /* 16 − 12 ≈ 8 */
+```
+
+### 22 Border that dies at the corner
+Put the radius and the border on the same box; never let a clip eat a stroke.
+```diff
+- <div class="rounded-xl overflow-hidden"> /* wrapper owns the radius… */
+- <table class="border divide-y">…</table> /* …child owns the stroke — erased at every corner */
+- </div>
++ <div class="rounded-xl overflow-hidden border border-[--rule]"> /* same box: the stroke wraps the arc */
++ <table class="divide-y">…</table>
++ </div>
+```
+Or keep the hairlines as dividers: run them straight, edge to edge, and drop
+the radius from the fill — square-cornered regions need no arc.
+
+### 23 Badge & pill spam
+Delete decorative pills; keep at most a real status tag.
+```diff
+- <h1>Dashboard</h1><Pill>✨ New</Pill><Pill>🔥 Popular</Pill><Pill>β Beta</Pill>
++ <h1>Dashboard</h1><span class="ver">v2.1</span>
+```
+
+### 24 AI-drawn SVG icons
+Get a real, high-quality icon: commission a designer, or generate one with the
+best image model and refine it until it's crisp and on-brand.
+```diff
+- <svg viewBox="0 0 48 48"><circle cx="24" cy="24" r="20"/><circle cx="18" cy="20" r="2"/>…</svg>
++ <img src="/icon.svg" alt="" /> /* a real icon: a designer, or a strong image model, refined */
+```
+Don't ship the crude blob the model sketched, and don't fall back to a bare
+letter; a crude generated icon is worse than no picture at all.
+
+### 25 Icon in a tint of itself
+Let the icon inherit the text color with no container; if it truly needs one,
+give it a deliberate opaque surface.
+```diff
+- <div class="rounded-lg bg-blue-500/10 p-2"><Icon class="text-blue-500"/></div>
++ <Icon class="text-[--ink]"/> /* just an icon; no tinted tile */
+```
+
+### 26 The springy hover
+Transition only the properties that carry the state change, at 120–200ms with a
+standard ease; hover feedback is a surface shift, not growth.
+```diff
+- class="transition-all duration-500 hover:scale-105 hover:-translate-y-2 hover:shadow-2xl"
++ class="transition-colors duration-150 hover:bg-[--surface-2] hover:border-[--rule-strong]"
+```
+Never animate layout properties (width/height/margin/padding); save spring
+easing for things that genuinely move through space.
+
+### 27 The wobbling spinner
+Give the rotation a fixed centre; never put centering and spinning in the same
+`transform` — a keyframe replaces the whole property.
+```diff
+- .spinner { position: absolute; top: 50%; left: 50%;
+- transform: translate(-50%, -50%); animation: spin 1s linear infinite; }
+- @keyframes spin { to { transform: rotate(360deg); } } /* clobbers the translate */
++ .spinner-box { position: absolute; inset: 0; display: grid; place-items: center; }
++ .spinner { animation: spin 1s linear infinite; } /* rotates in place */
+```
+Centre the artwork too: the SVG arc centred on its viewBox, `transform-origin`
+left at center (or use the standalone `rotate` property, which composes with
+`translate` instead of replacing it). Then watch one full revolution before
+moving on.
+
+### 28 The all-caps card grid
+Replace the grid of equal-weight cards with the single most important point,
+told fully; drop the ALL-CAPS micro-labels.
+```diff
+- <div class="grid grid-cols-3 gap-8"> …6 icon+CAPS-label+one-liner cards… </div>
++ <p class="lead">It replaces your standups.</p>
++ <p>Every morning it reads yesterday's commits and PRs and writes the team a
++ three-line summary.</p>
+```
+
+### 29 The invented stat row
+Keep only measured, sourced numbers; delete the set dressing.
+```diff
+- <div class="stats"><b>10k+</b> Developers <b>99.9%</b> Uptime <b>24/7</b> Support</div>
++ <p><b>1,847</b> CI runs yesterday, median 3m 12s — from the public status page.</p>
+```
+One real, checkable figure beats three round ones. No numbers yet? Say what the
+product does instead.
+
+### 30 The 01 / 02 / 03 section markers
+Delete ornamental ordinals on unordered sections; number only real sequences.
+```diff
+- <span class="text-8xl font-extrabold text-gray-100">01</span><h2>Collaborate</h2>
+- <span class="text-8xl font-extrabold text-gray-100">02</span><h2>Innovate</h2>
++ <h2>Collaborate</h2> /* sections distinguished by scale and space */
+```
+Install steps, changelogs, and catalogues have earned their numbers; keep those.
+
+### 31 Cards inside cards
+One surface per region; group inside it with spacing and hairlines.
+```diff
+- <div class="card"><div class="card"><div class="card">Pro — $8/mo</div></div></div>
++ <div class="card">
++ <h3>Billing</h3>
++ <div class="row">Plan <b>Pro — $8/mo</b></div> /* rows split by hairlines */
++ <div class="row">Renews <b>May 3</b></div>
++ </div>
+```
+A child keeps its own surface only when it's genuinely a separate object (a
+preview, an embed).
+
+### 32 One gap everywhere
+Space by relationship: pull a heading toward its own rows, push groups apart.
+```diff
+- <div class="space-y-4">
+- <h3>Profile</h3><p>Name</p><p>Email</p>
+- <h3>Danger zone</h3><p>Delete workspace</p>
+- </div>
++ <section class="mb-8">
++ <h3 class="mb-1.5">Profile</h3><p>Name</p><p>Email</p>
++ </section>
++ <section>
++ <h3 class="mb-1.5">Danger zone</h3><p>Delete workspace</p>
++ </section>
+```
+Use a small scale with real jumps (4/8/16/32/64), unevenly on purpose.
+
+### 33 Inter everywhere
+Choose a face like you'd choose a logo: try a few, set your own copy in each,
+and be able to say why this one.
+```diff
+- font-family: "Space Grotesk", sans-serif; /* display */
+- font-family: "Inter", sans-serif; /* body — the stock pairing */
++ font-family: var(--font-sans); /* one face, compared and chosen — with the
++ reason recorded in the tokens file */
+```
+Landing back on Inter after comparing is a choice; starting there isn't. A
+system stack picked for a reason is a choice too. Propose candidates; let the
+user pick — never swap a brand font silently.
+
+### 34 The tasteful terminal
+Move monospace back to code; use terminal metaphors only where they serve the
+product.
+```diff
+- <body class="font-mono bg-[#0a0a0a] text-amber-400">
+- <pre> ╔══════════════╗
+- ║ WELCOME ║
+- ╚══════════════╝</pre>
++ <body class="font-sans bg-[--bg] text-[--ink]">
++ <h1>Welcome</h1> /* mono stays in <code>/<pre> for actual code */
+```
+
+### 35 The editorial dashboard
+Type follows the job: sans + tabular lining numerals for scanned surfaces;
+serif display only where the surface is genuinely editorial.
+```diff
+- <h1 class="font-serif text-5xl text-emerald-950">Good evening, Mara.</h1>
+- <p class="italic font-serif text-emerald-800/70">The quiet rhythm of your services.</p>
+- <div class="stat font-serif text-4xl">3</div>
++ <header class="flex items-baseline justify-between">
++ <h1 class="text-sm font-semibold">On-call — payments</h1><time>22:41 UTC</time>
++ </header>
++ <div class="stat text-3xl font-bold tabular-nums">3</div>
+```
diff --git a/.agents/skills/penguin-harness-dev/reference/ai-slop/scan.mjs b/.agents/skills/penguin-harness-dev/reference/ai-slop/scan.mjs
new file mode 100644
index 00000000..dbc7cf9b
--- /dev/null
+++ b/.agents/skills/penguin-harness-dev/reference/ai-slop/scan.mjs
@@ -0,0 +1,508 @@
+#!/usr/bin/env node
+/*
+ kill-ai-slop scanner — dependency-free.
+
+ Walks a project's frontend source and greps for the code-level signals of each
+ AI-slop tell (see references/detection.md). Prints a grouped report of
+ file:line hits. It NEVER edits files. Every hit is a lead to confirm by
+ reading the code, not a verdict.
+
+ Usage:
+ node scan.mjs [root] [--json] [--no-color]
+ [--only=01,06] [--skip=19] [--exclude=path] [--rules=extra.mjs]
+
+ Suppressing confirmed-intentional hits, in source comments:
+ deslop-ignore [ids…] suppress hits on the same line
+ deslop-ignore-next-line [ids…] suppress hits on the next line
+ deslop-ignore-file [ids…] suppress hits in the whole file
+ Without ids the directive suppresses every tell; with ids (e.g. 06 19) only those.
+*/
+
+import { readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { dirname, extname, join, relative, resolve } from "node:path";
+
+const args = process.argv.slice(2);
+const root = args.find((a) => !a.startsWith("-")) || ".";
+const asJson = args.includes("--json");
+const normalizeId = (value) => (/^\d+$/.test(value) ? value.padStart(2, "0") : value);
+const flagValues = (name) =>
+ args
+ .filter((a) => a.startsWith(`--${name}=`))
+ .flatMap((a) => a.slice(name.length + 3).split(","))
+ .map((s) => s.trim())
+ .filter(Boolean);
+const onlyIds = new Set(flagValues("only").map(normalizeId));
+const skipIds = new Set(flagValues("skip").map(normalizeId));
+const excludes = flagValues("exclude");
+const rulesFiles = flagValues("rules");
+const useColor =
+ !args.includes("--no-color") && process.stdout.isTTY && !asJson;
+// realpath both roots so the "skip the skill's own files" check still works
+// when one path arrives through a symlink (macOS /var/folders vs /private/var).
+const realpathOr = (p) => {
+ try {
+ return realpathSync(p);
+ } catch {
+ return p;
+ }
+};
+const resolvedRoot = realpathOr(resolve(root));
+const skillRoot = realpathOr(resolve(dirname(fileURLToPath(import.meta.url)), ".."));
+const escapeTerminal = (text) => text.replace(/[\0-\x1f\x7f-\x9f]/g, (char) =>
+ `\\x${char.codePointAt(0).toString(16).padStart(2, "0")}`,
+);
+
+const SKIP_DIRS = new Set([
+ "node_modules", ".git", "dist", "build", "out", ".next", ".astro",
+ ".output", ".svelte-kit", ".nuxt", "coverage", "vendor", ".cache",
+ ".vercel", ".turbo",
+]);
+const EXTS = new Set([
+ ".html", ".css", ".scss", ".sass", ".less",
+ ".tsx", ".jsx", ".ts", ".js", ".mjs", ".cjs",
+ ".vue", ".svelte", ".astro", ".md", ".mdx",
+ ".php", ".twig",
+]);
+
+// A tell: id, human name, one-line fix, and the line patterns that flag it.
+// `code` tells only look at code/style files; `copy` tells also read prose.
+const TELLS = [
+ { id: "01", group: "color", name: "indigo→violet gradient", fix: "one solid, chosen accent",
+ patterns: [
+ /from-(indigo|violet|purple|fuchsia)-\d+[\s\S]{0,60}?to-(purple|violet|fuchsia|pink)-\d+/i,
+ /(linear-gradient|bg-gradient)[^;"'`]*(#6366f1|#8b5cf6|#a855f7|#7c3aed)/i,
+ /shadow-(purple|violet|indigo)-\d+\/\d+/i,
+ ] },
+ { id: "02", group: "color", name: "gradient-clip headline", fix: "solid ink, scale up",
+ patterns: [
+ /bg-clip-text[\s\S]{0,40}?text-transparent|text-transparent[\s\S]{0,40}?bg-clip-text/,
+ /(?:-webkit-)?background-clip:\s*text/i,
+ /-webkit-text-fill-color:\s*transparent/i,
+ ] },
+ { id: "03", group: "color", name: "warm ‘cozy’ palette", fix: "neutral base + one warm accent",
+ patterns: [
+ /\b(amber|orange|stone)-(50|100|200|300)\b/i,
+ /bg-\[#(?:fdf6ec|fef3e2|faf3e8|fff7ed|fdf4e3)\]/i,
+ /(text|border)-amber-\d+/i,
+ /text-(?:gray|slate|zinc|neutral)-(?:400|500)[^"'\n]{0,60}bg-(?:amber|stone|orange|rose|blue|indigo|green)-/i,
+ ] },
+ { id: "04", group: "color", name: "default semantic palette", fix: "one palette: neutrals + a couple of chosen states",
+ patterns: [
+ /bg-(?:blue|indigo)-50|bg-amber-50|bg-(?:green|emerald)-50|bg-red-50/i,
+ /(?:info|success|warning|error)[^\n]{0,30}(?:blue|green|amber|red)-(?:50|100|500|600|700)/i,
+ ] },
+ { id: "05", group: "color", name: "one-hue status box", fix: "state in words; one muted accent on neutral",
+ patterns: [
+ /border-(red|amber|yellow|green|blue)-\d+[\s\S]{0,60}?text-\1-\d+/i,
+ /bg-(?:red|amber|yellow|green)-\d+\/(?:5|10|15|20)\b/i,
+ /(?:error|warning|success)[^\n]{0,40}(?:red|amber|yellow|green)-\d+/i,
+ ] },
+ { id: "06", group: "color", name: "gradients as atmosphere", fix: "one flat bg; depth from a hairline",
+ patterns: [
+ /radial-gradient/i,
+ /linear-gradient[^;)]*(?:to bottom|180deg|to top)/i,
+ /bg-gradient-to-[bt]\b[\s\S]{0,40}?from-/i,
+ /repeating-(?:linear|radial)-gradient/i,
+ /bg-gradient-to-(?:br|tr|bl|tl)\b[\s\S]{0,40}?from-(?:emerald|green|teal|cyan|purple|violet|fuchsia)-\d+\/(?:5|10|15|20|25)/i,
+ /box-shadow:[^;{}]*(?:#(?:6366f1|8b5cf6|a855f7|22d3ee|06b6d4)|rgba?\(\s*(?:139|168))/i,
+ ] },
+ { id: "07", group: "type", name: "serif-italic emphasis", fix: "emphasise by weight, one voice",
+ patterns: [
+ /font-serif\b/i,
+ /font-family:\s*(?:georgia|"?playfair|"?lora|"?cormorant)/i,
+ ] },
+ { id: "08", group: "type", name: "serif where sans belongs", fix: "one legible UI sans",
+ patterns: [
+ /font-family:\s*[^;]*(playfair|cormorant|lora|dm serif|libre baskerville)/i,
+ /fontFamily[^;\n]*(Playfair|Cormorant|Lora)/,
+ /font-serif[^"'\n]{0,60}(?:italic|text-[4-9]xl)|(?:\bitalic\b|text-[4-9]xl)[^"'\n]{0,60}font-serif/i,
+ ] },
+ { id: "09", group: "type", name: "decorative strikes & highlights", fix: "strike for edits, underline for links",
+ patterns: [
+ /\bline-through\b/i,
+ /<(?:mark|s|u|del|strike)[\s>]/i,
+ /text-decoration:\s*(?:line-through|underline)/i,
+ ] },
+ { id: "10", group: "type", name: "kicker above every heading", fix: "delete kickers that restate the heading",
+ patterns: [
+ /\buppercase\b[\s\S]{0,40}?tracking-(?:wide|wider|widest)\b|tracking-(?:wide|wider|widest)\b[\s\S]{0,40}?\buppercase\b/i,
+ /\b(?:eyebrow|kicker|overline)\b/i,
+ /text-transform:\s*uppercase[\s\S]{0,80}?letter-spacing:\s*0?\.\d+em/i,
+ ] },
+ { id: "11", group: "type", name: "full-sentence display headline", fix: "few words big; specifics in a subline",
+ patterns: [
+ /\btext-(?:5|6|7|8|9)xl\b/,
+ /tracking-tighter?\b[\s\S]{0,40}?font-(?:extrabold|black)|font-(?:extrabold|black)[\s\S]{0,40}?tracking-tighter?\b/i,
+ /font-size:\s*(?:[5-9]\d(?:\.\d+)?px|[4-9](?:\.\d+)?rem)/i,
+ /letter-spacing:\s*-0?\.0[5-9]/i,
+ ] },
+ { id: "12", group: "type", name: "flat type hierarchy", fix: "few steps, ≥1.25× between them",
+ patterns: [
+ /<h[12][^>]*text-(?:sm|base|lg)\b/i,
+ ] },
+ { id: "13", group: "copy", name: "highlighted keywords", fix: "let structure carry emphasis",
+ copy: true,
+ patterns: [
+ /<mark[\s>]/i,
+ /text-(primary|indigo|purple|violet)-\d+/,
+ ] },
+ { id: "14", group: "copy", name: "AI copywriting voice", fix: "say the specific thing",
+ copy: true,
+ patterns: [
+ /not just .{1,40}\bit(?:['’])?s\b/i,
+ /\b(say goodbye to|meet your new|supercharge|unlock the power of|in seconds,? not)\b/i,
+ /\b(blazing[- ]fast|effortless(?:ly)?|seamless(?:ly)?|game[- ]?changer|next[- ]level)\b/i,
+ /\b(?:growth|security|process|privacy|productivity|compliance|feature|innovation) theater\b/i,
+ ] },
+ { id: "15", group: "copy", name: "emoji everywhere", fix: "cut emoji from product copy",
+ copy: true,
+ patterns: [
+ /\p{Extended_Pictographic}/u,
+ ] },
+ { id: "16", group: "component", name: "glowing status dot", fix: "flat dot + a word; no halo",
+ patterns: [
+ /\banimate-(?:ping|pulse)\b/i,
+ /shadow-(?:green|emerald|lime)-\d+\/\d+/i,
+ /(?:ready|online|live)[\s\S]{0,40}?(?:●|rounded-full)/i,
+ ] },
+ { id: "17", group: "component", name: "left-border callout", fix: "one aside, rest is body",
+ patterns: [
+ /border-l-4[\s\S]{0,40}?rounded|rounded[\s\S]{0,40}?border-l-4/i,
+ /\b(admonition|callout|note-box)\b/i,
+ /\bborder-2\b[\s\S]{0,40}?border-(indigo|purple|violet|blue|pink|green)-\d+/i,
+ ] },
+ { id: "18", group: "component", name: "pastel icon tiles", fix: "labelled list with specifics",
+ patterns: [
+ /rounded-(lg|xl|2xl)\s+bg-(indigo|purple|blue|green|amber|pink)-(50|100)/i,
+ /<svg[^>]*(?:width|height)="(?:9[6-9]|[1-9]\d{2})"/i,
+ ] },
+ { id: "19", group: "component", name: "max-radius / glassmorphism", fix: "one small radius, solid surfaces",
+ patterns: [
+ /\brounded-full\b/,
+ /backdrop-blur|backdrop-filter:\s*blur|bg-(?:white|black)\/(?:5|10|20|30)/i,
+ /border-radius:\s*(?:9999px|50%|2rem|24px)/i,
+ ] },
+ { id: "20", group: "component", name: "oversized drop shadow", fix: "tight elevation, never bigger than the element",
+ patterns: [
+ /box-shadow:[^;{}]*\b(?:[6-9]\d|\d{3,})px/i,
+ /shadow-\[[^\]]*\b(?:[6-9]\d|\d{3,})px/i,
+ /filter:[^;{}]*drop-shadow\([^)]*\b(?:[6-9]\d|\d{3,})px/i,
+ /\bborder\b[\s\S]{0,40}?shadow-(?:xl|2xl)\b|shadow-(?:xl|2xl)\b[\s\S]{0,40}?\bborder\b/,
+ ] },
+ { id: "21", group: "component", name: "corners that don't nest", fix: "inner = outer − padding",
+ patterns: [
+ /\brounded-(?:xl|2xl|3xl)\b/i,
+ /border-radius:\s*(?:1rem|1\.5rem|24px|32px)/i,
+ ] },
+ { id: "22", group: "component", name: "border dies at the corner", fix: "radius and border on the same box",
+ patterns: [
+ /rounded-(?:lg|xl|2xl|3xl)[^"'\n]{0,60}overflow-(?:hidden|clip)|overflow-(?:hidden|clip)[^"'\n]{0,60}rounded-(?:lg|xl|2xl|3xl)/i,
+ /clip-path:\s*inset\([^)]*round/i,
+ /\bborder-[trbl]\b[^"'\n]{0,60}rounded-(?:lg|xl|2xl|3xl)|rounded-(?:lg|xl|2xl|3xl)[^"'\n]{0,60}\bborder-[trbl]\b/i,
+ ] },
+ { id: "23", group: "component", name: "badge / pill spam", fix: "badges only for real status",
+ patterns: [
+ /rounded-full[\s\S]{0,40}?bg-(indigo|purple|green|amber|pink)-(50|100|200)/i,
+ />\s*(?:[✨🔥🎉🚀]\s*)?(new|beta|hot|popular|pro|coming soon)\s*</i,
+ ] },
+ { id: "24", group: "component", name: "AI-drawn SVG icon", fix: "a real, high-quality icon (a designer, or a strong image model)",
+ patterns: [
+ /<circle[^>]*\br="[1-9]/i,
+ /(?:mascot|blob)\.svg/i,
+ ] },
+ { id: "25", group: "component", name: "icon in a tint of itself", fix: "no tinted tile; inherit text color",
+ patterns: [
+ /bg-(indigo|blue|green|amber|red|purple|pink)-\d+\/(?:5|10|15|20)[\s\S]{0,60}?text-\1-/i,
+ /text-(indigo|blue|green|amber|red|purple|pink)-\d+[\s\S]{0,60}?bg-\1-\d+\/(?:5|10|15|20)/i,
+ ] },
+ { id: "26", group: "motion", name: "springy hover", fix: "transition what changes, 120–200ms, standard ease",
+ patterns: [
+ /hover:(?:scale-1[01]\d|-translate-y-)/i,
+ /\btransition-all\b/,
+ /cubic-bezier\([^)]*,\s*1\.[2-9]/,
+ /\banimate-bounce\b/,
+ /transition:[^;{}]*\b(?:width|height|margin|padding)\b/i,
+ ] },
+ // Leads only — the wobble itself is visual. A centering translate near a spin
+ // keyframe is the classic clobber; an off-centre transform-origin near a spin
+ // animation is the other spelling of the same bug.
+ { id: "27", group: "motion", name: "wobbly spinner", fix: "fixed rotation centre; keep centering out of the animated transform",
+ patterns: [
+ /translate\(-50%,\s*-50%\)[\s\S]{0,600}?@keyframes\s+[\w-]*(?:spin|rotate|load)/i,
+ /@keyframes\s+[\w-]*(?:spin|rotate|load)[\w-]*\s*\{[\s\S]{0,160}?transform:\s*rotate\([^)]*\)\s*;?\s*\}[\s\S]{0,600}?translate\(-50%,\s*-50%\)/i,
+ /(?:\banimate-spin\b|animation:[^;{}]*\b[\w-]*spin)[\s\S]{0,200}?transform-origin:\s*(?!center\b|50%\s*50%)[\w.% -]/i,
+ /transform-origin:\s*(?!center\b|50%\s*50%)[\w.% -]+;[\s\S]{0,200}?(?:\banimate-spin\b|animation:[^;{}]*\b[\w-]*spin)/i,
+ ] },
+ { id: "28", group: "layout", name: "all-caps card grid", fix: "show the one key thing fully",
+ patterns: [
+ /\bgrid-cols-3\b/,
+ /\buppercase\b[\s\S]{0,30}?(?:text-xs|tracking-wide)/i,
+ /\b(everything you need|why (?:you.?ll love|choose|teams))\b/i,
+ ] },
+ { id: "29", group: "layout", name: "invented stat row", fix: "only measured, sourced numbers",
+ copy: true,
+ patterns: [
+ /\b\d+[km]\+[\s\S]{0,30}?(?:developers|users|teams|customers|downloads|stars)/i,
+ /99\.9+%/,
+ /\b24\/7\b/,
+ ] },
+ { id: "30", group: "layout", name: "01/02/03 section markers", fix: "number only real sequences",
+ patterns: [
+ /['"`>]0[1-9]['"`<]/,
+ /text-[789]xl[\s\S]{0,50}?(?:text-(?:gray|slate|zinc|neutral)-(?:100|200)|opacity-(?:5|10|20))/i,
+ /\bstep[- ](?:one|two|three)\b/i,
+ ] },
+ { id: "31", group: "layout", name: "cards inside cards", fix: "one surface per region; hairlines inside",
+ patterns: [
+ /<(Card|Panel|Box)[^>]*>\s*<\1\b/,
+ ] },
+ { id: "32", group: "layout", name: "one gap everywhere", fix: "space by relationship, not by token",
+ patterns: [
+ /(space-y-4|gap-4)\b[\s\S]{0,120}?\b(space-y-4|gap-4)\b/,
+ ] },
+ { id: "33", group: "evolved", name: "Inter everywhere", fix: "compare faces; be able to say why this one",
+ patterns: [
+ /fonts\.googleapis\.com\/css2\?family=(?:Inter|Space\+Grotesk|Manrope|Plus\+Jakarta)/i,
+ /font-family:\s*[^;]*(?:\bInter\b|Space Grotesk|Manrope|Plus Jakarta Sans|\bGeist\b)/,
+ /\b(?:Inter|Space_Grotesk|Manrope|Plus_Jakarta_Sans)\b[\s\S]{0,60}?next\/font\/google|next\/font\/google[\s\S]{0,60}?\b(?:Inter|Space_Grotesk|Manrope|Plus_Jakarta_Sans)\b/,
+ ] },
+ { id: "34", group: "evolved", name: "tasteful-terminal", fix: "mono for code only",
+ patterns: [
+ /\bfont-mono\b/,
+ /font-family:\s*[^;]*(?:mono|jetbrains|fira code|ibm plex mono|geist mono)/i,
+ /[╔╗╚╝║═▓▒░]/,
+ ] },
+ // Editorial serif faces beyond tell 08's list, the greeting-as-headline, and
+ // opt-in oldstyle figures — the "magazine dashboard" kit. Serif on genuinely
+ // editorial surfaces (docs, essays) is not this tell; confirm before fixing.
+ { id: "35", group: "evolved", name: "editorial-dashboard", fix: "sans + tabular numerals for scanned UI",
+ patterns: [
+ />\s*Good (?:morning|afternoon|evening),/i,
+ /font-family:\s*[^;]*(?:fraunces|canela|tiempos|didot|freight|reckless|newsreader)/i,
+ /oldstyle-nums|font-variant-numeric:\s*oldstyle/i,
+ ] },
+];
+
+// Extra rule modules (--rules=file.mjs): each exports an array of tells shaped
+// like the entries above. Patterns may be RegExp or plain strings (compiled
+// case-insensitive). Lets language- or stack-specific rules live outside core.
+for (const rulesPath of rulesFiles) {
+ let extra;
+ try {
+ const mod = await import(pathToFileURL(resolve(rulesPath)).href);
+ extra = mod.default ?? mod.tells;
+ } catch (err) {
+ console.error(`Could not load rules file ${escapeTerminal(rulesPath)}: ${err.message}`);
+ process.exit(1);
+ }
+ if (!Array.isArray(extra)) {
+ console.error(`Rules file ${escapeTerminal(rulesPath)} must export an array of tells`);
+ process.exit(1);
+ }
+ for (const tell of extra) {
+ if (!tell || typeof tell.id !== "string" || typeof tell.name !== "string" ||
+ !Array.isArray(tell.patterns) || tell.patterns.length === 0) {
+ console.error(`Rules file ${escapeTerminal(rulesPath)}: each tell needs a string id, a name, and a non-empty patterns array`);
+ process.exit(1);
+ }
+ TELLS.push({
+ id: tell.id,
+ group: tell.group || "custom",
+ name: tell.name,
+ fix: tell.fix || "",
+ copy: Boolean(tell.copy),
+ patterns: tell.patterns.map((p) => (p instanceof RegExp ? p : new RegExp(p, "iu"))),
+ });
+ }
+}
+
+const isExcluded = (path) => {
+ if (excludes.length === 0) return false;
+ const rel = relative(resolvedRoot, path);
+ return excludes.some((token) => rel.includes(token));
+};
+
+function walk(dir, files = []) {
+ if (resolve(dir) === skillRoot) return files;
+ let entries;
+ try {
+ entries = readdirSync(dir, { withFileTypes: true });
+ } catch {
+ return files;
+ }
+ for (const e of entries) {
+ if (e.name.startsWith(".") && e.name !== ".") {
+ if (SKIP_DIRS.has(e.name)) continue;
+ }
+ const full = join(dir, e.name);
+ if (isExcluded(full)) continue;
+ if (e.isDirectory()) {
+ if (SKIP_DIRS.has(e.name) || resolve(full) === skillRoot) continue;
+ walk(full, files);
+ } else if (e.isFile()) {
+ const base = e.name;
+ if (/\.min\.(js|css)$/.test(base)) continue;
+ if (/(package-lock|pnpm-lock|yarn\.lock)/.test(base)) continue;
+ const ext = extname(base);
+ if (EXTS.has(ext) || /^tailwind\.config\./.test(base)) files.push(full);
+ }
+ }
+ return files;
+}
+
+function scanFile(path) {
+ let text;
+ try {
+ const st = statSync(path);
+ if (st.size > 512 * 1024) return []; // skip large/generated files
+ text = readFileSync(path, "utf8");
+ } catch {
+ return [];
+ }
+ const isCode = extname(path) !== ".md";
+ const lines = text.split(/\r?\n/);
+
+ // deslop-ignore directives, parsed once per file. Ids are the tokens after
+ // the directive that contain a digit ("06", "ru-14"); none means all tells.
+ const parseIds = (tail) => {
+ const ids = (tail.match(/[\w-]+/g) || []).filter((t) => /\d/.test(t)).map(normalizeId);
+ return ids.length ? new Set(ids) : null; // null = every tell
+ };
+ const lineIgnores = new Map(); // lineIndex -> null (all) | Set of ids
+ let fileIgnore; // undefined | null (all) | Set of ids
+ const addLineIgnore = (idx, ids) => {
+ if (idx < 0 || idx >= lines.length || lineIgnores.get(idx) === null) return;
+ if (ids === null) return void lineIgnores.set(idx, null);
+ const set = lineIgnores.get(idx) || new Set();
+ for (const id of ids) set.add(id);
+ lineIgnores.set(idx, set);
+ };
+ for (let i = 0; i < lines.length; i++) {
+ const m = lines[i].match(/deslop-ignore(-file|-next-line)?\b(.*)$/);
+ if (!m) continue;
+ const ids = parseIds(m[2]);
+ if (m[1] === "-file") {
+ if (ids === null) fileIgnore = null;
+ else if (fileIgnore !== null) {
+ fileIgnore = fileIgnore || new Set();
+ for (const id of ids) fileIgnore.add(id);
+ }
+ } else if (m[1] === "-next-line") addLineIgnore(i + 1, ids);
+ else addLineIgnore(i, ids);
+ }
+ if (fileIgnore === null) return [];
+ const isSuppressed = (id, lineIndex) => {
+ if (fileIgnore && fileIgnore.has(id)) return true;
+ const ig = lineIgnores.get(lineIndex);
+ return ig === null || (ig !== undefined && ig.has(id));
+ };
+
+ const lineStarts = [0];
+ for (let index = text.indexOf("\n"); index !== -1; index = text.indexOf("\n", index + 1)) {
+ lineStarts.push(index + 1);
+ }
+ const hits = [];
+ const seen = new Set();
+ for (const tell of TELLS) {
+ if (onlyIds.size > 0 && !onlyIds.has(tell.id)) continue;
+ if (skipIds.has(tell.id)) continue;
+ if (!tell.copy && !isCode) continue; // code-only tell in a prose file
+ for (const pattern of tell.patterns) {
+ const matcher = new RegExp(pattern.source, `${pattern.flags}g`);
+ let match;
+ while ((match = matcher.exec(text))) {
+ let low = 0;
+ let high = lineStarts.length - 1;
+ while (low < high) {
+ const middle = Math.ceil((low + high) / 2);
+ if (lineStarts[middle] <= match.index) low = middle;
+ else high = middle - 1;
+ }
+ const lineIndex = low;
+ const line = lines[lineIndex];
+ if (line.length > 2000) continue; // minified-ish
+ const key = `${tell.id}:${lineIndex}`;
+ if (!seen.has(key) && !isSuppressed(tell.id, lineIndex)) {
+ seen.add(key);
+ hits.push({ tell, line: lineIndex + 1, text: line.trim().slice(0, 100) });
+ }
+ if (match[0] === "") matcher.lastIndex += 1;
+ }
+ }
+ }
+ return hits;
+}
+
+// ---- run ----
+try {
+ if (!statSync(resolvedRoot).isDirectory()) {
+ throw new Error("not a directory");
+ }
+} catch {
+ console.error(`Scan root must be an existing directory: ${escapeTerminal(root)}`);
+ process.exit(1);
+}
+
+const files = walk(resolvedRoot);
+const byTell = new Map(); // id -> { tell, hits: [{file,line,text}] }
+for (const f of files) {
+ for (const h of scanFile(f)) {
+ if (!byTell.has(h.tell.id)) byTell.set(h.tell.id, { tell: h.tell, hits: [] });
+ byTell.get(h.tell.id).hits.push({ file: relative(resolvedRoot, f) || f, line: h.line, text: h.text });
+ }
+}
+
+const groups = [...byTell.values()].sort((a, b) => a.tell.id.localeCompare(b.tell.id));
+const totalHits = groups.reduce((n, g) => n + g.hits.length, 0);
+
+if (asJson) {
+ console.log(
+ JSON.stringify(
+ {
+ root,
+ filesScanned: files.length,
+ groups: groups.length,
+ hits: totalHits,
+ findings: groups.map((g) => ({
+ id: g.tell.id,
+ group: g.tell.group,
+ name: g.tell.name,
+ fix: g.tell.fix,
+ hits: g.hits,
+ })),
+ },
+ null,
+ 2,
+ ),
+ );
+ process.exit(0);
+}
+
+const c = (code, s) => (useColor ? `\x1b[${code}m${s}\x1b[0m` : s);
+const red = (s) => c("31", s);
+const dim = (s) => c("2", s);
+const bold = (s) => c("1", s);
+
+console.log(`\n${bold("kill-ai-slop")} — scanned ${files.length} files under ${escapeTerminal(root)}\n`);
+if (groups.length === 0) {
+ console.log("No slop signals found. (Still trust your eyes — open the pages.)\n");
+ process.exit(0);
+}
+
+for (const g of groups) {
+ console.log(`${red("slop")} ${bold(g.tell.id)} ${g.tell.name} ${dim("→ " + g.tell.fix)}`);
+ const shown = g.hits.slice(0, 12);
+ for (const h of shown) {
+ console.log(` ${dim(escapeTerminal(h.file + ":" + h.line))} ${escapeTerminal(h.text)}`);
+ }
+ if (g.hits.length > shown.length) {
+ console.log(dim(` … and ${g.hits.length - shown.length} more`));
+ }
+ console.log("");
+}
+
+console.log(
+ `${bold("→")} ${groups.length} groups, ${totalHits} hits. ` +
+ dim("Confirm each by reading the code, then fix per references/fixes.md.\n"),
+);
diff --git a/.agents/skills/penguin-harness-dev/reference/ai-slop/taxonomy.md b/.agents/skills/penguin-harness-dev/reference/ai-slop/taxonomy.md
new file mode 100644
index 00000000..28a16dad
--- /dev/null
+++ b/.agents/skills/penguin-harness-dev/reference/ai-slop/taxonomy.md
@@ -0,0 +1,343 @@
+# The AI-slop taxonomy
+
+35 tells, in two tiers. **Classic** = widely recognised. **Evolved** = newer
+defaults that already read as templated. For each: what it is, why it reads as
+machine-made, and the fix. Detection patterns live in `detection.md`; code
+patches in `fixes.md`.
+
+The rule under every entry: slop is the *absence of a decision*. A tell is only
+slop when it's a default nobody chose. The same element, chosen and defended,
+is fine.
+
+## Color
+
+**01 · Indigo→violet gradient** — the `#6366f1 → #a855f7` diagonal on buttons,
+glows, and hero backgrounds. It's the factory setting of Tailwind demos and
+template galleries, so it reads as an absence of a decision.
+*Fix:* one justified accent; if a gradient, give it direction and a reason, not
+a "premium" sticker.
+
+**02 · Gradient headline text** — `background-clip:text` rainbow fills on
+headings. Trades legibility and contrast for an effect every AI page uses;
+decoration eats the message.
+*Fix:* solid color for headings; build hierarchy with size, weight, and space.
+
+**03 · Warm "cozy" palette** — amber/stone/orange wash on soft beige. The
+model's laziest translation of "warm and friendly": Tailwind's warm ramp served
+raw, so every "human" product looks identical.
+*Fix:* neutral base + one restrained warm accent; warmth comes from words.
+
+**04 · The default semantic palette** — info in blue/indigo, tip in amber,
+success in green, error in red: the framework's stock `-50` backgrounds with
+`-600` text. Nobody picked these hues; three or four unrelated candy colors,
+related to nothing — not your brand, not each other. A bowl of default rainbow
+candy where every box shouts a different colour.
+*Fix:* grow semantic colours out of your one palette (tints of a hue plus
+neutrals); colour only the states that truly differ. Most notes need no colour.
+
+**05 · The one-hue status box** — a status or alert where the border, text, and
+background are all one hue, the background just a see-through version of it: red
+on red, yellow on yellow, green on green. The framework reflex
+(`border-red-500`, `text-red-500`, `bg-red-500/10`), one loud hue at three
+opacities, nothing toned to sit next to your UI. Red/yellow/green is a traffic
+light, not a palette.
+*Fix:* carry the state in words and weight first — a bold "Error" reads before
+colour does. If you colour at all, one muted accent from your own palette on a
+neutral surface.
+
+**06 · Gradients as atmosphere** — a near-black blue page with a soft glow up
+top and cards whose surface is itself a gradient, lighter above and darker
+below: the default "premium dark mode." The glow and surface gradients carry no
+information; it's the move a model makes to look premium in the dark, the same
+midnight blue with a spotlight behind a thousand AI pages. Same family:
+bento cards each washed in a tint of their own accent — the green card gets a
+green gradient, the purple card a purple one — plus repeating-gradient stripes
+as surface decoration, and colored box-shadow glows used as dark-mode accents.
+*Fix:* pick one flat background and hold it; build surface depth with a hairline
+and a restrained shadow. If a glow must exist, let it point at something.
+
+## Type
+
+**07 · Serif-italic on one word** — swapping one word in a sans headline to
+serif italic for "emphasis." Cheap drama that stages two voices in one sentence;
+the most viral AI headline tic.
+*Fix:* emphasise with weight, position, or a line break; keep one voice, and if
+you truly need italic use the same family's italic.
+
+**08 · Serif where sans belongs** — Playfair/Lora/Cormorant display serif on a
+dev tool or SaaS, as body/UI text or as an oversized italic-serif hero
+headline. The model equates "premium" with "serif"; display serifs are hard to
+read at UI sizes and tonally off, a tuxedo on a terminal. The italic-serif hero
+reads as taste in isolation — by now it's the universal AI-startup landing
+page uniform.
+*Fix:* one legible sans you chose; serif only when you want that voice, and a
+text serif not a display one. Set the hero roman, or use a non-serif display
+face (a genuinely editorial product may keep it — judge by context).
+
+**09 · Decorative strikes & highlights** — striking out, underlining, or
+swiping a highlighter over a word, not to delete or annotate but as decorative
+"emphasis." The same disease as serif-emphasis: the model doesn't trust the
+words to carry weight, so it draws on them.
+*Fix:* let weight, size, line breaks, and structure carry emphasis; keep strike
+for real edits, underline for links, highlight for real annotation.
+
+**10 · The kicker above every heading** — a tiny uppercase, letter-spaced label
+above the hero headline, then another above every section heading: FEATURES,
+HOW IT WORKS, TESTIMONIALS. The kicker is an editorial device for *adding*
+information (a section, a date, a category); the AI page stamps it as a reflex,
+and the label restates what the heading already says. Zero information, worn as
+a hat on every heading — a template's rhythm, not a decision.
+*Fix:* delete any kicker that restates its heading; keep one only where it adds
+a real dimension. Let scale and space introduce sections.
+
+**11 · The full-sentence display headline** — a whole marketing sentence set at
+display size (`text-6xl font-extrabold tracking-tight`), wrapping to three or
+four lines and eating the first viewport. Display sizes are for the two or
+three words that can carry that scale; the model doesn't know which words yours
+are, so it sets the whole pitch huge and crushes the tracking to look
+"designed." Size standing in for the decision about what matters. (The
+killaislop.com site itself did it — its definition section set a whole
+sentence at display size until this entry forced the fix.)
+*Fix:* compress the one thing into a few words and let those be big; say the
+rest in a normal-size subline. Tighten tracking only as far as the face was
+designed to go.
+
+**12 · The flat type hierarchy** — every size on the page crammed between 14
+and 18px: headings barely bigger than body, labels barely smaller, hierarchy
+left entirely to shades of gray. The opposite failure of the display-size
+sentence, and the same absence: nobody decided what matters most. The model
+plays it safe (`text-lg` heading, `text-sm` everything else), so a reader
+can't tell the page's one important thing from its footnotes.
+*Fix:* a scale with few steps and real contrast between them (1.25× and up);
+give the most important thing a size that says so. If two sizes are within a
+pixel or two, merge them.
+
+## Copy
+
+**13 · Highlighted keywords** — coloring or bolding scattered words
+mid-paragraph, like a highlighter ran over it. When every word is emphasised,
+none is; it's the signature of not knowing the point.
+*Fix:* let sentence structure carry emphasis — at most one accent per paragraph.
+
+**14 · The AI copywriting voice** — "It's not just X — it's Y", "Say goodbye to
+X", punchy three-word triads, an em-dash habit, dismissing things as "X
+theater." A rhythmic fingerprint: symmetrical, one notch too excited,
+specifics-free.
+*Fix:* write something specific — real numbers, nouns, consequences; say it the
+way one person explains it to another.
+
+**15 · Emoji everywhere** — an emoji on every heading, button, and bullet: 🚀
+launch, ⚡ fast, 🔒 secure, 🎉 delight. Borrowed warmth standing in for tone
+that copy and design should carry; a glyph before every point is louder, not
+clearer.
+*Fix:* cut decorative emoji from the UI; keep one only where it genuinely
+carries information, like a real status.
+
+## Components
+
+**16 · The glowing status dot** — a status indicator (online / ready / live)
+drawn as a solid dot in a pale halo, usually pulsing, almost always saturated
+green; at its most decorative, glued into a hero marketing pill, playing status
+for a tagline with no state behind it. A status is a tiny signal; the halo,
+pulse, and breathing glow carry no information. Inflating a binary state into a
+glowing gem is textbook overdesign.
+*Fix:* a small, flat, single-color dot plus a word; no halo, no pulse. Colour
+only when the state actually matters or changes — and if nothing is live behind
+it, no dot at all.
+
+**17 · Rounded card, colored left border** — a pale rounded box with a 4px
+colored bar down the left, wrapped around every list item, not just a "Tip/Note"
+but feature points and changelog rows. A docs admonition turned into universal
+decoration, so every row looks like an "important note" and none is. Sibling
+move: a thick accent ring (`border-2` in a loud color) around a rounded card
+to make one tier "pop."
+*Fix:* let a list be a list — alignment, spacing, hierarchy. Callouts are
+scarce: one or two a page, only for a genuine aside.
+
+**18 · Rounded-square icon tiles** — every feature gets a rounded-square chip +
+a line icon, tiled into a grid. Shortest path to "looks designed"; the icons
+rarely relate to the content, they just fill the grid. Same reflex at another
+size: a giant decorative line icon (`w-24 h-24`) parked in a card as filler.
+*Fix:* an icon must carry meaning or go; a clear label + one sentence beats a
+row of glyphs.
+
+**19 · Max radius + glassmorphism** — everything a max-radius pill; every card a
+translucent `backdrop-blur` pane. A frozen slice of 2021 Dribbble; effect
+presets unrelated to what the product says.
+*Fix:* one radius, held site-wide (usually small); depth from solid surfaces and
+space, not blur.
+
+**20 · The oversized drop shadow** — a small card or icon casting a huge, soft
+shadow that bleeds far past it on every side: big blur, low opacity, almost no
+offset. A shadow says how high a surface floats, and real light gives a tight
+contact shadow plus a soft ambient one with the blur tracking the height; this
+one tracks nothing. A big soft blur reads as "depth" in a thumbnail but maps to
+no real height — atmosphere standing in for elevation. Variant: the "ghost
+card," a hairline border *plus* a wide diffuse shadow on the same card — two
+separators doing one job; commit to an edge or an elevation, not both.
+*Fix:* a small elevation scale, held: tight blur, small offset, low opacity,
+never a shadow bigger than the thing casting it. Often a hairline does the
+separating and no shadow is needed; keep it colorless — a tinted glow isn't depth.
+
+**21 · Corners that don't nest** — the same radius on every layer: a big-radius
+outer box with an inner box at the same big radius, so the corners don't sit
+concentrically and the inner arc fights the outer one. Nested corners have a
+rule (inner = outer − gap); AI UIs skip the math and stamp one radius token on
+everything.
+*Fix:* compute the nested radius (inner = outer − padding), or don't round the
+inner element at all; keep a small, deliberate radius scale.
+
+**22 · The border that dies at the corner** — a rounded rectangle with a 1px
+hairline on its straight edges and nothing at the corners: the outline runs to
+the tangent points and stops, the arcs go naked. It happens because the radius
+and the border live on different boxes. The model memorized a recipe — content
+that can't round its own corners (a table, an image, a list, a scroll area)
+gets wrapped in `rounded-xl overflow-hidden` — while the child component ships
+with its own 1px border or dividers. Every line is locally correct: the
+wrapper owns the radius, the child owns the stroke. But the square stroke ring
+falls outside the rounded clip at all four corners and gets erased; the
+straight runs survive inside the clip. The model never renders its own output,
+so it never sees the corner; a human sees the broken edge in one glance. The
+fingerprint of code that's right line by line and wrong as a whole.
+*Fix:* put the radius and the border on the same box — border + border-radius
+on one element, and the stroke wraps the arc for free. If an outer layer
+genuinely must clip content, move the border up onto the clipping layer too.
+Inverse holds: if the lines are really dividers, keep them straight, run them
+edge to edge, and don't round the fill.
+
+**23 · Badge and pill spam** — "✨ New", "β Beta", "🔥 Popular" decorative pills
+everywhere. Manufacturing fake buzz; in bulk each stops meaning anything.
+*Fix:* a badge only for real status (a version, stock).
+
+**24 · AI-drawn SVG icons** — asking a model to "draw an icon" and shipping what
+comes back: a round blob with two dot eyes, a mascot of primitive shapes, a logo
+that's a rounded square with a face. Vector art the machine can't really draw,
+used as the product's mark; it looks like placeholder art that never got
+replaced.
+*Fix:* get a real, high-quality icon. Commission a designer, or generate one
+with the best image model and refine it until it's crisp and on-brand. A crude
+SVG the model sketched, or a bare fallback letter, isn't a mark worth shipping.
+
+**25 · Icon in a tint of itself** — every icon wrapped in a rounded square
+filled with a see-through tint of its own color: a blue icon on faint blue, a
+green one on faint green (`bg-{color}/10` behind `text-{color}`). A one-line
+reflex — pad, round, wash in 10% of the icon's hue — so the page becomes a grid
+of soft colored squares.
+*Fix:* let an icon just be an icon; inherit the text color, no container. If
+something genuinely needs one, give it a deliberate opaque surface from your
+palette, not a tint of the icon it holds.
+
+## Motion
+
+**26 · The springy hover** — every card, button, and image wearing
+`hover:scale-105` and `transition-all`: touch it and it grows, lifts, and
+bounces on an elastic ease. Motion is information — what changed, where a thing
+went, what's interactive — and scaling a card on hover says nothing; the card
+isn't growing, and the user already knows the cursor is on it. `transition-all`
+is the tell inside the tell: animating every property is the absence of
+deciding which one means something.
+*Fix:* transition only the properties that carry the state change (background,
+border, opacity), 120–200ms, standard ease. Hover feedback is a surface shift,
+not growth; save spring physics for things that genuinely move through space.
+
+**27 · The wobbling spinner** — a loading spinner that doesn't turn around its
+own centre: the arc wobbles, tracing a little circle as it spins. Off-centre
+artwork, a stray `transform-origin`, or a rotate keyframe that clobbers the
+centering `translate(-50%, -50%)` (a keyframe replaces the whole `transform`).
+A spinner has exactly one job — rotate in place around a fixed point — and
+anyone who runs the page sees the wobble within half a second; shipping it is
+an admission that nobody ever watched the interface move. Other tells are an
+absence of taste; this one is an absence of looking. It lands at the worst
+moment: the user has nothing to do but stare, and the most-watched element on
+the page is limping. "Loading" reads as "broken."
+*Fix:* give the rotation a real centre: artwork centred in its own box (the
+SVG arc centred on the viewBox), `transform-origin` at center, and centering
+kept out of the animated `transform` — position with a wrapper or the
+standalone `rotate` property. Then watch one full revolution.
+
+## Layout
+
+**28 · The all-caps card grid** — an ALL-CAPS label plus a number or icon,
+copied into rows of interchangeable cards: feature grids and dashboard
+stat-cards alike. It fakes structure while stuffing unrelated things into
+identical boxes; the ALL-CAPS micro-label is the default costume for "looks
+designed."
+*Fix:* decide the single most important thing and show it fully; if you must
+list, use real hierarchy and contrast, not a grid of equal-weight cards.
+
+**29 · The invented stat row** — three big numbers in a row: 10k+ developers,
+99.9% uptime, 24/7 support, on a product that launched yesterday. Social proof
+turned into a layout, filled whether or not the proof exists; the numbers are
+set dressing (a round 10k+, two nines, a 24/7), not measurements. Real numbers
+are odd and specific — and one invented figure poisons every true one beside it.
+*Fix:* show a number only if you measured it, and say where it came from; one
+real, checkable figure beats three round ones. No numbers yet? Say what the
+product does.
+
+**30 · The 01 / 02 / 03 section markers** — a giant faint ordinal beside every
+marketing section (01 Collaborate, 02 Innovate, 03 Scale) as if they were steps
+in a sequence. Numbering is a claim that these things happen in this order;
+feature sections have no order, so the numerals are costume borrowed from
+editorial design where an index means something. The cheapest way to look
+structured without deciding on a structure.
+*Fix:* number what's genuinely ordered — install steps, a changelog, a
+catalogue — and delete the ornamental ordinals everywhere else.
+
+**31 · Cards inside cards** — a bordered, rounded, shadowed card holding
+another card holding another, every layer with its own surface and padding. A
+card claims its content is one self-contained thing; nested three deep, nothing
+is contained and the padding stacks until content is a sliver. The model boxes
+because a box is the only grouping move it trusts — grouping by spacing and
+alignment requires deciding what belongs together.
+*Fix:* one surface per region; inside it, group with spacing, alignment, and
+hairline dividers. A child earns its own surface only when it's genuinely a
+separate object (a preview, an embed).
+
+**32 · One gap everywhere** — `gap-4`, `p-4`, `space-y-4`: one spacing value
+stamped across the page, so a heading sits exactly as far from its own body as
+from the previous, unrelated section. Spacing is how a layout says what belongs
+together — tight inside a group, generous between groups. One value everywhere
+announces that nothing belongs to anything; proximity stops carrying
+information, and the eye has to read every line to find the structure.
+*Fix:* space by relationship, not by token: pull related lines close, push
+unrelated groups apart. A small scale with real jumps (4/8/16/32/64), used
+unevenly on purpose.
+
+## Evolved slop
+
+**33 · Inter everywhere** — Space Grotesk for display, Inter for body; or
+Geist, Manrope, Plus Jakarta Sans. Every AI-built page draws from the same five
+faces. They're good typefaces — that's the trap: the model reaches for them
+because everyone did, and every product wearing them dissolves into the same
+page. A typeface is the loudest single signal of who made this; outsourcing it
+to the training-data average dodges the identity decision the way the indigo
+gradient dodged the color one.
+*Fix:* choose a face the way you'd choose a logo — try a few, set your own copy
+in each, be able to say why this one. Landing back on Inter after that is a
+choice; starting there isn't. (A system stack, picked for a reason, is a choice
+too.)
+
+**34 · The "tasteful terminal"** — mono everywhere, a near-black background, one
+warm accent, ASCII art: the look of "an AI that read one Vercel blog post." It
+isn't ugly, that's the trap; it's polished enough to have become the new
+default, dodging the design decision exactly like the indigo gradient did, in
+cooler clothing.
+*Fix:* keep monospace for code, not UI chrome; use ASCII art and terminal
+metaphors only where they serve the product. Real taste is a choice you can
+explain, not this season's safest template.
+
+**35 · The editorial dashboard** — an operational UI dressed as a magazine: a
+giant serif "Good evening" greeting, serif numerals in the stat cards, cream
+paper, a tracked-caps kicker over every block. The second-wave uniform:
+scolded out of indigo gradients, the model's new shorthand for "taste" is
+cream + display serif + one deep accent, stamped on any surface regardless of
+its job. The greeting is lifted from a chat assistant's home screen, where the
+greeting is the content; a dashboard's content is its numbers, and display
+serifs with proportional oldstyle figures are prose type — the numerals you
+can't scan down a column. A magazine is read once; a console is scanned all
+day.
+*Fix:* match the type to the job — a scanned interface takes a legible sans
+with tabular lining numerals, hierarchy from scale and space. Display serif
+belongs to genuinely editorial surfaces (docs, essays, a magazine). For
+warmth, one material decision — a paper tint or an ink accent — not the full
+costume.
diff --git a/.prettierignore b/.prettierignore
index e17f6912..9e90ffe2 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -25,3 +25,7 @@ coverage/
# Playwright e2e artifacts
test-results/
playwright-report/
+
+# vendored verbatim from upstream (see the dev skill's reference/ai-slop.md); kept byte-identical
+# so a refresh is a plain copy
+.agents/skills/penguin-harness-dev/reference/ai-slop/