chill-agent 1.0.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +50 -41
- package/package.json +1 -1
- package/skills/chill-slop/SKILL.md +241 -52
- package/skills/chill-slop-code/SKILL.md +91 -35
- package/skills/chill-slop-copywriting/SKILL.md +76 -29
- package/skills/chill-slop-human/SKILL.md +65 -13
- package/skills/chill-slop-mobile/SKILL.md +86 -17
- package/skills/chill-slop-ui/SKILL.md +110 -31
- package/src/auditor.js +44 -11
- package/src/installer.js +13 -10
- package/src/prompts.js +1 -1
|
@@ -1,33 +1,80 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: chill-slop-copywriting
|
|
3
|
-
description: "
|
|
3
|
+
description: "Comprehensive Copywriting & Authentic Voice Standard. Strips robotic AI marketing fluff, hype words, and hallucinated metrics in favor of sharp, technical prose a busy human understands in one read."
|
|
4
|
+
license: MIT
|
|
4
5
|
---
|
|
5
6
|
|
|
6
|
-
# ChillSlop Copywriting: Authentic
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
7
|
+
# ChillSlop Copywriting: Comprehensive Authentic Voice Standard
|
|
8
|
+
|
|
9
|
+
> *"Write with the precision of an engineer and the brevity of an editor."*
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. The Banned Vocabulary Index (50+ AI Cliches)
|
|
14
|
+
|
|
15
|
+
Strip these words and phrases immediately upon detection:
|
|
16
|
+
|
|
17
|
+
| Banned AI Buzzword | Why It Fails | What to Use Instead |
|
|
18
|
+
|---|---|---|
|
|
19
|
+
| **"Unleash the power of..."** | Lazy, overused AI cliché. | Name the specific tool and its concrete function. |
|
|
20
|
+
| **"Seamlessly integrate / Effortless"** | Minimizes technical complexity; reads like marketing spam. | Name the protocol: *"Installs via stdio JSON-RPC in 1 command."* |
|
|
21
|
+
| **"Supercharge your workflow"** | Hollow hype with no empirical meaning. | Provide benchmark figures: *"Cuts compilation time from 12s to 4s."* |
|
|
22
|
+
| **"Next-generation / Cutting-edge"** | Meaningless assertion that dates quickly. | State the architecture: *"Written in native C++20 with WAL mode."* |
|
|
23
|
+
| **"Revolutionary / Game-changer"** | Inflated self-praise. | Describe the mechanism: *"First debugger to support deterministic parent-DAG forks."* |
|
|
24
|
+
| **"Dive in / Delve into / Let's explore"** | Unmistakable GPT filler opener. | Delete entirely. Start directly with the technical step. |
|
|
25
|
+
| **"Robust and scalable"** | Vague engineering hand-waving. | Specify limits: *"Handles 15,000 req/sec across 4 worker threads."* |
|
|
26
|
+
| **"Empower developers to..."** | Paternalistic marketing jargon. | State the action: *"Inspect, rewind, and replay LLM trajectories."* |
|
|
27
|
+
| **"Look no further!"** | Cheesy infomercial script. | Delete entirely. State the product's identity plainly. |
|
|
28
|
+
| **"Tailored to your needs"** | Empty corporate filler. | Explain customization hooks: *"Configurable via JSON schema."* |
|
|
29
|
+
| **"Magic / Magically"** | Obscures mechanical operation. | Explain the algorithm: *"Canonicalizes JSON keys before SHA-256 hashing."* |
|
|
30
|
+
| **"In today's fast-paced world"** | High school essay introductory fluff. | Delete entirely. |
|
|
31
|
+
| **"A testament to..."** | Robotic academic phrase. | State the result directly. |
|
|
32
|
+
| **"Pivotal / Paramount"** | Pseudo-intellectual filler. | Use "critical", "essential", or plain language. |
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 2. The Em Dash (`—`) Ban & Clean Punctuation
|
|
37
|
+
|
|
38
|
+
- **The Rule:** The em dash character (`—`) is strictly banned in all generated text and UI copy.
|
|
39
|
+
- **Why:** Large language models excessively insert em dashes to simulate literary sophistication, resulting in an unmistakable AI signature.
|
|
40
|
+
- **Direct Replacements:**
|
|
41
|
+
- *Bad:* "Fast, reliable — and built for teams."
|
|
42
|
+
- *Good (Comma):* "Fast, reliable, and built for teams."
|
|
43
|
+
- *Good (Colon):* "Built for teams: fast, reliable, and deterministic."
|
|
44
|
+
- *Good (Separate Sentences):* "Built for teams. Fast and reliable."
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## 3. The Specificity Mandate
|
|
49
|
+
|
|
50
|
+
Replace abstract claims with concrete engineering realities:
|
|
51
|
+
|
|
52
|
+
### Example 1: Product Descriptions
|
|
53
|
+
- **Slop:** *"ChillRewind is an ultra-fast, modern AI proxy that saves you lots of money and prevents stuck loops."*
|
|
54
|
+
- **Craft:** *"ChillRewind is a zero-dependency local proxy running on `node:sqlite` in WAL mode. It prunes stale tool outputs over 1.5KB and halts agent runs when the same tool signature repeats 3 consecutive times."*
|
|
55
|
+
|
|
56
|
+
### Example 2: Performance Claims
|
|
57
|
+
- **Slop:** *"Experience blazing-fast response times and incredible token efficiency."*
|
|
58
|
+
- **Craft:** *"Replays cached LLM turns with 0ms latency and $0.00 upstream cost."*
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## 4. Microcopy, Buttons & Interface Verbs
|
|
63
|
+
|
|
64
|
+
### Action-Oriented Buttons
|
|
65
|
+
Every interactive button must pair an **imperative verb** with a **direct object**:
|
|
66
|
+
- **Banned:** `Get Started`, `Learn More`, `Submit`, `Click Here`, `Explore`, `Continue`.
|
|
67
|
+
- **Approved:** `Fork Session`, `Export JSON`, `Connect Database`, `Copy API Key`, `Download Log`, `Verify Hash`.
|
|
68
|
+
|
|
69
|
+
### Honest Error Messages
|
|
70
|
+
Every error message must state three facts: (1) what failed, (2) why it failed, and (3) the exact resolution command.
|
|
71
|
+
- **Slop:** *"Oops! Something went wrong while saving your session. Please try again later."*
|
|
72
|
+
- **Craft:** *"SQLite write failed: database file `.chillrewind/store.db` is locked by process PID 4120. Run `chill-agent doctor` or terminate stale proxy instances."*
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## 5. Social Proof & Statistics
|
|
77
|
+
|
|
78
|
+
- **The Rule:** Never invent statistics (*"Trusted by 10,000+ developers"*), fake customer headshots, or fabricated quotes.
|
|
79
|
+
- If verified customer metrics or official case studies exist, cite them with links.
|
|
80
|
+
- If verified data is not available, **omit the section entirely**. An empty section or no testimonials builds far higher trust than fabricated praise.
|
|
@@ -1,21 +1,73 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: chill-slop-human
|
|
3
|
-
description: "
|
|
3
|
+
description: "Comprehensive Ergonomics, Human Factors & Accessibility Standard. Enforces WCAG AA 4.5:1 contrast, visible focus rings, 44px touch targets, Escape-key dialogs, and accessible screen-reader semantics."
|
|
4
|
+
license: MIT
|
|
4
5
|
---
|
|
5
6
|
|
|
6
|
-
# ChillSlop Human: Ergonomics & Accessibility
|
|
7
|
+
# ChillSlop Human: Comprehensive Ergonomics & Accessibility Standard
|
|
7
8
|
|
|
8
|
-
|
|
9
|
+
> *"Accessibility is not an optional polish phase. An interface that cannot be used by everyone is simply an unfinished interface."*
|
|
9
10
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. Contrast Ratios & Visual Legibility
|
|
14
|
+
|
|
15
|
+
### WCAG AA Minimum Thresholds
|
|
16
|
+
- **Normal Body Text (< 18pt regular):** Minimum contrast ratio of **4.5:1** against its immediate background.
|
|
17
|
+
- **Large Text (>= 18pt regular or >= 14pt bold):** Minimum contrast ratio of **3:1**.
|
|
18
|
+
- **Interactive UI Components & Hairlines:** Minimum contrast ratio of **3:1** against adjacent surfaces.
|
|
19
|
+
|
|
20
|
+
### Banned Contrast Sins
|
|
21
|
+
- **No Low-Contrast Gray-on-Gray Slop:** Never place `#71717A` body text on a `#18181B` card surface. Secondary metadata may use muted text only if text size is at least 11px and contrast is verified >= 4.5:1.
|
|
22
|
+
- **No White Text Over Light Gradients:** If using a gradient, text passing over it must maintain 4.5:1 contrast across the *entire* gradient spectrum, not just the dark endpoint.
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## 2. Keyboard Navigation & Focus Management
|
|
27
|
+
|
|
28
|
+
### Visible Focus Indicators
|
|
29
|
+
- Every interactive element (`<button>`, `<a>`, `<input>`, `<select>`, `<textarea>`) must display a visible, unclipped focus indicator upon keyboard Tab navigation:
|
|
30
|
+
```css
|
|
31
|
+
:focus-visible {
|
|
32
|
+
outline: 2px solid #818CF8;
|
|
33
|
+
outline-offset: 2px;
|
|
34
|
+
}
|
|
35
|
+
```
|
|
36
|
+
- **FORBIDDEN:** Setting `outline: none` or `outline: 0` without immediately supplying a custom focus indicator.
|
|
37
|
+
|
|
38
|
+
### Modals, Drawers & Focus Trapping
|
|
39
|
+
- **Escape Key Interception:** Any open modal, drawer, dropdown, or overlay dialog MUST close immediately upon pressing the `Escape` key.
|
|
40
|
+
- **Focus Restoration:** Upon closing an overlay, focus must return directly to the trigger button that launched it.
|
|
41
|
+
- **Focus Trap:** When a modal is open, keyboard `Tab` cycles only through interactive elements inside the modal; background page content must be inert (`aria-hidden="true"` or `inert`).
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 3. Touch Targets & Tactile Ergonomics
|
|
46
|
+
|
|
47
|
+
- **Minimum Dimensions:** All buttons, toggle switches, links, and icon triggers on touch screens must measure at least **44x44px** (or provide 44px of hit area via padding).
|
|
48
|
+
- **Spacing Between Targets:** Adjacent touch controls must have at least `8px` of separation to prevent accidental mis-taps.
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## 4. Semantics & Screen Reader Affordances
|
|
53
|
+
|
|
54
|
+
### Native HTML First
|
|
55
|
+
- Use `<button>` for actions. Use `<a href="...">` for navigation to real URLs.
|
|
56
|
+
- **FORBIDDEN:** `<div onClick={...}>` or `<span onClick={...}>` without `role="button"`, `tabIndex={0}`, and `onKeyDown` handlers.
|
|
13
57
|
|
|
14
|
-
|
|
15
|
-
-
|
|
16
|
-
|
|
17
|
-
-
|
|
58
|
+
### Icon Buttons & Accessible Labels
|
|
59
|
+
- Every button containing only an SVG or icon glyph **MUST** have an accessible text label:
|
|
60
|
+
```html
|
|
61
|
+
<button aria-label="Close dialog">
|
|
62
|
+
<svg aria-hidden="true">...</svg>
|
|
63
|
+
</button>
|
|
64
|
+
```
|
|
65
|
+
- All decorative images must declare empty `alt=""`. All content images must have concise, descriptive `alt` text.
|
|
18
66
|
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
|
|
67
|
+
### Form Fields
|
|
68
|
+
- Every `<input>`, `<textarea>`, and `<select>` must have a visible `<label>` bound via `id` and `for`:
|
|
69
|
+
```html
|
|
70
|
+
<label for="session-id">Session ID</label>
|
|
71
|
+
<input id="session-id" type="text" />
|
|
72
|
+
```
|
|
73
|
+
- Never rely solely on `placeholder="..."` as the field label. Placeholders disappear when typed and fail contrast checks.
|
|
@@ -1,26 +1,95 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: chill-slop-mobile
|
|
3
|
-
description: "Mobile
|
|
3
|
+
description: "Comprehensive Mobile & Responsive Engineering Standard. Zero horizontal viewport overflow, fluid CSS clamp typography, thumb-zone ergonomics, and cleanly scrollable data views without bloated media queries."
|
|
4
|
+
license: MIT
|
|
4
5
|
---
|
|
5
6
|
|
|
6
|
-
# ChillSlop Mobile: Responsive Engineering
|
|
7
|
+
# ChillSlop Mobile: Comprehensive Responsive Engineering Standard
|
|
7
8
|
|
|
8
|
-
|
|
9
|
+
> *"A responsive design works everywhere by default, not through 50 brittle media query overrides."*
|
|
9
10
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. Zero Horizontal Overflow Mandate
|
|
14
|
+
|
|
15
|
+
- **The Rule:** The viewport must NEVER produce horizontal scrollbars (`overflow-x: hidden` on `<body>` is a lazy band-aid that hides layout defects; you must eliminate the protruding elements directly).
|
|
16
|
+
- **Causes & Fixes:**
|
|
17
|
+
- *Fixed Pixel Widths:* Never write `width: 600px`. Use `width: 100%; max-width: 600px;`.
|
|
18
|
+
- *Large Images / SVGs:* Ensure all images declare `max-width: 100%; height: auto;`.
|
|
19
|
+
- *Code Blocks & Data Tables:* Wrap tables and code views inside an explicit horizontal scrolling container:
|
|
20
|
+
```css
|
|
21
|
+
.table-wrapper {
|
|
22
|
+
width: 100%;
|
|
23
|
+
overflow-x: auto;
|
|
24
|
+
-webkit-overflow-scrolling: touch;
|
|
25
|
+
border: 1px solid #26262E;
|
|
26
|
+
border-radius: 6px;
|
|
27
|
+
}
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## 2. Fluid Typography & The Modular Scale
|
|
33
|
+
|
|
34
|
+
Avoid massive static header font sizes that blow out mobile viewports. Use mathematical CSS `clamp()`:
|
|
35
|
+
|
|
36
|
+
### Fluid Header Formulas
|
|
37
|
+
```css
|
|
38
|
+
/* Responsive H1: 32px on 320px mobile up to 54px on 1280px desktop */
|
|
39
|
+
h1 {
|
|
40
|
+
font-size: clamp(2rem, 1.5rem + 2.5vw, 3.375rem);
|
|
41
|
+
line-height: 1.1;
|
|
42
|
+
letter-spacing: -0.025em;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/* Responsive H2: 24px on mobile up to 36px on desktop */
|
|
46
|
+
h2 {
|
|
47
|
+
font-size: clamp(1.5rem, 1.25rem + 1.25vw, 2.25rem);
|
|
48
|
+
line-height: 1.2;
|
|
49
|
+
}
|
|
13
50
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
51
|
+
/* Responsive Body */
|
|
52
|
+
p, body {
|
|
53
|
+
font-size: 14px;
|
|
54
|
+
line-height: 1.6;
|
|
55
|
+
}
|
|
56
|
+
@media (min-width: 768px) {
|
|
57
|
+
p, body {
|
|
58
|
+
font-size: 15px;
|
|
21
59
|
}
|
|
22
|
-
|
|
60
|
+
}
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## 3. Thumb-Zone Architecture & Safe Areas
|
|
66
|
+
|
|
67
|
+
### Ergonomic Zones
|
|
68
|
+
On mobile devices, user thumbs naturally rest on the bottom third of the screen:
|
|
69
|
+
- **Bottom Navigation & Actions:** Place high-frequency buttons (Submit, Filter, Fork, Run) in a sticky bottom action bar or within easy thumb reach.
|
|
70
|
+
- **Top Bar:** Reserve the top navigation bar for secondary navigation links, search, and settings.
|
|
71
|
+
|
|
72
|
+
### Hardware Safe Areas
|
|
73
|
+
Sticky bottom action bars and mobile drawers must respect mobile home indicators:
|
|
74
|
+
```css
|
|
75
|
+
.bottom-action-bar {
|
|
76
|
+
position: sticky;
|
|
77
|
+
bottom: 0;
|
|
78
|
+
padding-bottom: max(12px, env(safe-area-inset-bottom));
|
|
79
|
+
background: rgba(16, 16, 20, 0.95);
|
|
80
|
+
backdrop-filter: blur(8px);
|
|
81
|
+
border-top: 1px solid #26262E;
|
|
82
|
+
}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## 4. Mobile Breakpoints Architecture
|
|
88
|
+
|
|
89
|
+
Keep responsive logic lean. Do not declare 10 different media queries. Stick to 3 standard anchors:
|
|
23
90
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
91
|
+
| Breakpoint | Width | Target Layout |
|
|
92
|
+
|---|---|---|
|
|
93
|
+
| **Mobile** | `< 768px` | Single-column stacked layouts, bottom sheets, scrollable table containers. |
|
|
94
|
+
| **Tablet** | `768px - 1024px` | 2-column layouts, collapsible sidebars. |
|
|
95
|
+
| **Desktop**| `> 1024px` | Full multi-column workspaces, split diff inspectors, fixed navigation rails. |
|
|
@@ -1,35 +1,114 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: chill-slop-ui
|
|
3
|
-
description: "
|
|
3
|
+
description: "Comprehensive Visual Engineering Standard. Deep carbon monochrome palettes, 1px hairline borders, tabular monospace data, asymmetric layout density, and zero generic AI gradients or pill cards."
|
|
4
|
+
license: MIT
|
|
4
5
|
---
|
|
5
6
|
|
|
6
|
-
# ChillSlop UI: Visual
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
- **
|
|
30
|
-
- **
|
|
31
|
-
- **
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
7
|
+
# ChillSlop UI: Comprehensive Visual Engineering Standard
|
|
8
|
+
|
|
9
|
+
> *"Good design is as little design as possible. Less, but better — because it concentrates on the essential aspects."*
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. Color Architecture & Surface Hierarchy
|
|
14
|
+
|
|
15
|
+
### The Monochromatic Foundation
|
|
16
|
+
Build 90% of the interface in crisp monochromatic shades. This grounds the interface and lets content stand out:
|
|
17
|
+
|
|
18
|
+
| Layer | Hex Value | Purpose |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| **Canvas Background** | `#09090B` | Base canvas. Deep obsidian carbon, non-reflective. |
|
|
21
|
+
| **Panel Surface** | `#111114` | Sidebars, section containers, grouped blocks. |
|
|
22
|
+
| **Interactive Surface** | `#16161C` | Cards, table headers, text inputs, inactive buttons. |
|
|
23
|
+
| **Active / Hover Surface**| `#1E1E26` | Interactive hover targets, selected tabs. |
|
|
24
|
+
| **Hairline Border** | `#26262E` | 1px crisp separation lines. Never use blurry shadows for borders. |
|
|
25
|
+
| **Focus / Active Border** | `#3F3F4E` | Focus indicators, active cards, highlighted inputs. |
|
|
26
|
+
|
|
27
|
+
### Semantic Accent Discipline
|
|
28
|
+
Bright colors are strictly functional signals, never background wallpaper:
|
|
29
|
+
- **Emerald (`#10B981`):** Cache hits, active streams, verified statuses, low latencies.
|
|
30
|
+
- **Amber (`#F59E0B`):** Pruned content, warnings, pending transactions, rate-limits.
|
|
31
|
+
- **Rose (`#F43F5E`):** Circuit breakers, fatal errors, destructive actions, high drop-off.
|
|
32
|
+
- **Indigo (`#818CF8`):** Branched DAG sessions, active tabs, navigation anchors.
|
|
33
|
+
|
|
34
|
+
> **Dose Cap Rule:** No single screen may use more than 1 semantic accent color as a dominant highlight. A page painted with emerald borders, indigo buttons, and amber cards is rejected as AI Slop.
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## 2. Geometry, Elevation & Spacing
|
|
39
|
+
|
|
40
|
+
### Border Radius Hierarchy
|
|
41
|
+
Never make every element on the screen a pill bubble (`rounded-3xl` / `rounded-full`). Follow a strict radius scale:
|
|
42
|
+
- **Tags, Micro-Badges, Code Chips:** `4px`
|
|
43
|
+
- **Buttons, Text Inputs, Dropdown Items:** `6px`
|
|
44
|
+
- **Cards, Panels, Modals, Code Blocks:** `8px`
|
|
45
|
+
- **Outer Shell / Max Container:** `12px` (Never exceed `12px` for desktop utility interfaces).
|
|
46
|
+
|
|
47
|
+
### Depth Through Hairline Borders (No Muddy Shadows)
|
|
48
|
+
- Replace 20px-30px blurred ambient shadows with:
|
|
49
|
+
`border: 1px solid #26262E;`
|
|
50
|
+
- For elevated modal popups or floating dropdowns, use tight micro-ambient elevation:
|
|
51
|
+
`box-shadow: 0 4px 12px rgba(0, 0, 0, 0.6), 0 0 0 1px #26262E;`
|
|
52
|
+
|
|
53
|
+
### Modular Spacing Scale
|
|
54
|
+
Never use arbitrary padding or margins (e.g. `margin-top: 19px`). Follow the 4px/8px modular rhythm:
|
|
55
|
+
`4px` → `8px` → `12px` → `16px` → `24px` → `32px` → `48px` → `64px` → `96px`.
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## 3. Typography & Numerals
|
|
60
|
+
|
|
61
|
+
### Font Pairing Rules
|
|
62
|
+
- **Sans Display & Body:** Inter, Geist Sans, -apple-system, BlinkMacSystemFont, Roboto.
|
|
63
|
+
- **Data, Metrics, Code & Hashes:** JetBrains Mono, Fira Code, SF Mono, ui-monospace.
|
|
64
|
+
- **Letter Spacing:**
|
|
65
|
+
- Large Section Headers (>= 28px): `letter-spacing: -0.025em;`
|
|
66
|
+
- Body Text: `letter-spacing: normal;`
|
|
67
|
+
- Uppercase Metadata Badges (<= 11px): `letter-spacing: +0.05em; text-transform: uppercase;`
|
|
68
|
+
|
|
69
|
+
### The Tabular Monospace Mandate
|
|
70
|
+
Every timestamp, latency number, hash string, currency value, token counter, and percentage **MUST** use a monospace font or:
|
|
71
|
+
`font-variant-numeric: tabular-nums;`
|
|
72
|
+
*Why:* Proportional fonts cause layout shifting and jitter when real-time numbers update.
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## 4. Component Engineering Patterns
|
|
77
|
+
|
|
78
|
+
### Feature Sections (Breaking the 3-Card Cliche)
|
|
79
|
+
- **FORBIDDEN:** 3 identical feature cards with a centered circle icon, bold title, and 2 lines of lorem ipsum.
|
|
80
|
+
- **REQUIRED:** Asymmetric density:
|
|
81
|
+
- Card 1: Interactive live code preview or syntax block.
|
|
82
|
+
- Card 2: High-density tabular telemetry feed.
|
|
83
|
+
- Card 3: Split-screen flow diagram with step connectors.
|
|
84
|
+
|
|
85
|
+
### Buttons & Controls
|
|
86
|
+
- **Minimum Tap Target:** Mobile tap targets must measure at least `44x44px` (desktop compact controls may be `32px` to `36px` height with generous click padding).
|
|
87
|
+
- **Cursor Affordance:**
|
|
88
|
+
- Enabled: `cursor: pointer;`
|
|
89
|
+
- Disabled: `cursor: not-allowed; opacity: 0.45;`
|
|
90
|
+
- **Focus Rings:**
|
|
91
|
+
`outline: 2px solid #818CF8; outline-offset: 2px;`
|
|
92
|
+
Never ship `outline: none` without providing this high-visibility ring.
|
|
93
|
+
|
|
94
|
+
### Data Tables
|
|
95
|
+
- Always use zebra-striping or 1px hairline dividers: `border-bottom: 1px solid #26262E`.
|
|
96
|
+
- Numeric columns must align **Right**. Text columns align **Left**. Status badges align **Center**.
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## 5. Motion & Kinetic Physics
|
|
101
|
+
|
|
102
|
+
- **Timing Range:** `120ms` to `180ms` for micro-interactions (hovers, clicks); `220ms` to `280ms` for spatial transitions (drawers, dialogs).
|
|
103
|
+
- **Easing Curve:** `cubic-bezier(0.16, 1, 0.3, 1)` (Deceleration curve for crisp, tactile snap).
|
|
104
|
+
- **Reduced Motion Support:**
|
|
105
|
+
```css
|
|
106
|
+
@media (prefers-reduced-motion: reduce) {
|
|
107
|
+
*, ::before, ::after {
|
|
108
|
+
animation-duration: 0.01ms !important;
|
|
109
|
+
animation-iteration-count: 1 !important;
|
|
110
|
+
transition-duration: 0.01ms !important;
|
|
111
|
+
scroll-behavior: auto !important;
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
```
|
package/src/auditor.js
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
// src/auditor.js - Automated Anti-Slop
|
|
1
|
+
// src/auditor.js - Automated Anti-Slop & Over-Engineering Scanner
|
|
2
2
|
import fs from 'node:fs';
|
|
3
3
|
import path from 'node:path';
|
|
4
4
|
import { c } from './prompts.js';
|
|
5
5
|
|
|
6
6
|
const SLOP_PATTERNS = [
|
|
7
|
-
// 1. Visual Slop
|
|
7
|
+
// 1. Visual Slop (Anti-Slop UI)
|
|
8
8
|
{
|
|
9
9
|
id: 'VISUAL-01',
|
|
10
10
|
category: 'Visual Slop',
|
|
@@ -29,8 +29,34 @@ const SLOP_PATTERNS = [
|
|
|
29
29
|
name: 'Excessive Glassmorphic Blur',
|
|
30
30
|
fix: 'Ensure backdrop-blur is not stacked across cards, modals, and navbars simultaneously.'
|
|
31
31
|
},
|
|
32
|
+
{
|
|
33
|
+
id: 'VISUAL-04',
|
|
34
|
+
category: 'Visual Slop',
|
|
35
|
+
severity: 'MEDIUM',
|
|
36
|
+
regex: /body\s*\{[^}]*overflow-x\s*:\s*hidden/i,
|
|
37
|
+
name: 'Lazy Body Overflow Masking',
|
|
38
|
+
fix: 'Do not use overflow-x: hidden on body to mask layout bugs. Eliminate the protruding element width directly.'
|
|
39
|
+
},
|
|
40
|
+
|
|
41
|
+
// 2. Over-Engineering & Bloat (Ponytail Minimalism)
|
|
42
|
+
{
|
|
43
|
+
id: 'BLOAT-01',
|
|
44
|
+
category: 'Over-Engineering',
|
|
45
|
+
severity: 'HIGH',
|
|
46
|
+
regex: /class\s+[A-Za-z0-9]+Factory|class\s+[A-Za-z0-9]+AbstractBuilder|class\s+[A-Za-z0-9]+ProviderManager/i,
|
|
47
|
+
name: 'Premature Factory / Builder Abstraction',
|
|
48
|
+
fix: 'Ponytail YAGNI rule: replace speculative multi-class factory wrappers with a direct 1-line function or object literal.'
|
|
49
|
+
},
|
|
50
|
+
{
|
|
51
|
+
id: 'BLOAT-02',
|
|
52
|
+
category: 'Over-Engineering',
|
|
53
|
+
severity: 'MEDIUM',
|
|
54
|
+
regex: /import\s+.*lodash\/(cloneDeep|isEqual|merge)|import\s+is-number\s+from/i,
|
|
55
|
+
name: 'Unnecessary Micro-Dependency',
|
|
56
|
+
fix: 'Use native JavaScript standard library (`structuredClone`, `Object.assign`, or standard operators) instead of external micro-packages.'
|
|
57
|
+
},
|
|
32
58
|
|
|
33
|
-
//
|
|
59
|
+
// 3. Copywriting Slop
|
|
34
60
|
{
|
|
35
61
|
id: 'COPY-01',
|
|
36
62
|
category: 'Copywriting Slop',
|
|
@@ -43,7 +69,7 @@ const SLOP_PATTERNS = [
|
|
|
43
69
|
id: 'COPY-02',
|
|
44
70
|
category: 'Copywriting Slop',
|
|
45
71
|
severity: 'MEDIUM',
|
|
46
|
-
regex:
|
|
72
|
+
regex: /[✨🚀🎉💡🔥]/u,
|
|
47
73
|
name: 'AI Sparkle / Rocket Emoji Cliché',
|
|
48
74
|
fix: 'Strip emojis from marketing headlines, documentation, and interface button labels.'
|
|
49
75
|
},
|
|
@@ -55,8 +81,16 @@ const SLOP_PATTERNS = [
|
|
|
55
81
|
name: 'Hallucinated Social Proof',
|
|
56
82
|
fix: 'Cite verified customer metrics or remove synthetic testimonials entirely.'
|
|
57
83
|
},
|
|
84
|
+
{
|
|
85
|
+
id: 'COPY-04',
|
|
86
|
+
category: 'Copywriting Slop',
|
|
87
|
+
severity: 'MEDIUM',
|
|
88
|
+
regex: /—/u,
|
|
89
|
+
name: 'Em Dash (—) AI Writing Tic',
|
|
90
|
+
fix: 'R-02 rule: replace em dash with comma, period, colon, or parentheses.'
|
|
91
|
+
},
|
|
58
92
|
|
|
59
|
-
//
|
|
93
|
+
// 4. Code Hygiene Slop
|
|
60
94
|
{
|
|
61
95
|
id: 'CODE-01',
|
|
62
96
|
category: 'Code Hygiene',
|
|
@@ -74,7 +108,7 @@ const SLOP_PATTERNS = [
|
|
|
74
108
|
fix: 'Provide full working implementation or throw explicit NotImplementedError with actionable message.'
|
|
75
109
|
},
|
|
76
110
|
|
|
77
|
-
//
|
|
111
|
+
// 5. Human Factors & Accessibility
|
|
78
112
|
{
|
|
79
113
|
id: 'A11Y-01',
|
|
80
114
|
category: 'Human Factors',
|
|
@@ -120,7 +154,7 @@ export function autoFixFile(filePath) {
|
|
|
120
154
|
try {
|
|
121
155
|
let content = fs.readFileSync(filePath, 'utf8');
|
|
122
156
|
|
|
123
|
-
// 1. Strip marketing emojis
|
|
157
|
+
// 1. Strip marketing emojis
|
|
124
158
|
const strippedEmoji = content.replace(/[✨🚀🎉💡🔥]/gu, '');
|
|
125
159
|
if (strippedEmoji !== content) {
|
|
126
160
|
content = strippedEmoji;
|
|
@@ -149,7 +183,6 @@ export function autoFixFile(filePath) {
|
|
|
149
183
|
}
|
|
150
184
|
|
|
151
185
|
export function scanDirectory(dirPath) {
|
|
152
|
-
|
|
153
186
|
const allFindings = [];
|
|
154
187
|
|
|
155
188
|
function walk(current) {
|
|
@@ -180,11 +213,11 @@ export function scanDirectory(dirPath) {
|
|
|
180
213
|
}
|
|
181
214
|
|
|
182
215
|
export function printAuditReport(findings, targetDir = process.cwd()) {
|
|
183
|
-
console.log(`\n${c.bold}ChillAgent Anti-Slop
|
|
216
|
+
console.log(`\n${c.bold}ChillAgent Anti-Slop & Over-Engineering Audit${c.reset}`);
|
|
184
217
|
console.log(`${c.dim}Scanned directory: ${targetDir}${c.reset}\n`);
|
|
185
218
|
|
|
186
219
|
if (findings.length === 0) {
|
|
187
|
-
console.log(`${c.green}${c.bold}✔ Clean Codebase!${c.reset} No AI slop patterns or
|
|
220
|
+
console.log(`${c.green}${c.bold}✔ Clean Codebase!${c.reset} No AI slop patterns or premature over-engineering found.`);
|
|
188
221
|
return;
|
|
189
222
|
}
|
|
190
223
|
|
|
@@ -193,7 +226,7 @@ export function printAuditReport(findings, targetDir = process.cwd()) {
|
|
|
193
226
|
const lowCount = findings.filter((f) => f.severity === 'LOW').length;
|
|
194
227
|
|
|
195
228
|
console.log(
|
|
196
|
-
`Found ${c.bold}${findings.length}
|
|
229
|
+
`Found ${c.bold}${findings.length} infractions${c.reset} ` +
|
|
197
230
|
`(${c.coral}${highCount} High${c.reset}, ${c.amber}${medCount} Medium${c.reset}, ${c.gray}${lowCount} Low${c.reset}):\n`
|
|
198
231
|
);
|
|
199
232
|
|
package/src/installer.js
CHANGED
|
@@ -8,26 +8,29 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
|
8
8
|
const ROOT_DIR = path.resolve(__dirname, '..');
|
|
9
9
|
|
|
10
10
|
export const AVAILABLE_SKILLS = [
|
|
11
|
-
{ id: 'chill-slop', label: 'ChillSlop Master Filter (Core)', description: 'Hard gates,
|
|
12
|
-
{ id: 'chill-slop-
|
|
11
|
+
{ id: 'chill-slop', label: 'ChillSlop Master Filter (Anti-Slop + Ponytail Core)', description: 'Hard gates, YAGNI ladder, craftsmanship standard' },
|
|
12
|
+
{ id: 'chill-slop-code', label: 'ChillSlop Pragmatic Code', description: 'Smallest complete change, native APIs, zero over-engineering' },
|
|
13
|
+
{ id: 'chill-slop-ui', label: 'ChillSlop UI & Layout', description: 'Monochrome surfaces, 1px hairlines, non-generic cards' },
|
|
13
14
|
{ id: 'chill-slop-copywriting', label: 'ChillSlop Copywriting', description: 'Strip AI buzzwords, vague hype, fake testimonials' },
|
|
14
|
-
{ id: 'chill-slop-
|
|
15
|
-
{ id: 'chill-slop-human', label: 'ChillSlop Ergonomics & A11y', description: 'WCAG contrast, focus rings, 44px tap targets' },
|
|
15
|
+
{ id: 'chill-slop-human', label: 'ChillSlop Ergonomics & A11y', description: 'WCAG 4.5:1 contrast, visible focus rings, 44px tap targets' },
|
|
16
16
|
{ id: 'chill-slop-mobile', label: 'ChillSlop Mobile & Fluid', description: 'Clamp scaling, thumb reach zones, zero overflow' }
|
|
17
17
|
];
|
|
18
18
|
|
|
19
|
-
export function generatePointerBlock(selectedSkills = ['chill-slop']) {
|
|
19
|
+
export function generatePointerBlock(selectedSkills = ['chill-slop'], intensity = 'full') {
|
|
20
20
|
const lines = [
|
|
21
21
|
'<!-- chill-agent:start -->',
|
|
22
|
-
'## ChillAgent Anti-Slop 2.0
|
|
22
|
+
'## ChillAgent Anti-Slop 2.0 & Pragmatic Senior Dev Standard (Ponytail + Anti-Slop)',
|
|
23
|
+
`Active Mode: \`${intensity}\` (Options: lite | full | ultra). Switch anytime with \`/chill <mode>\`.`,
|
|
24
|
+
'',
|
|
23
25
|
'Before generating or editing any code, interface, copy, or architecture in this workspace, follow these active skills:',
|
|
24
26
|
...selectedSkills.map((s) => `- \`skills/${s}/SKILL.md\``),
|
|
25
27
|
'',
|
|
26
28
|
'### Core Operating Rules:',
|
|
27
|
-
'1. **
|
|
28
|
-
'2. **
|
|
29
|
-
'3. **
|
|
30
|
-
'4. **Time-Travel
|
|
29
|
+
'1. **The Smallest Complete Change (Ponytail):** Take the shortest path that solves the whole task: standard library > existing codebase helper > installed dependency > minimum new code. No premature abstractions or wrapper factories.',
|
|
30
|
+
'2. **Purpose Test (Anti-Slop):** Every visual decision, color accent, layout structure, and copy phrase must name a specific domain purpose. AI defaults (purple gradients, rounded-3xl cards, generic cards) are forbidden.',
|
|
31
|
+
'3. **Liveliness Bar:** Avoid sterile defaults by reading `DESIGN.md`. If `DESIGN.md` is missing, adhere strictly to Linear/Geist carbon monochromatic standards.',
|
|
32
|
+
'4. **Context Hygiene & Time-Travel:** Strip conversational fluff and emojis. When debugging stochastic agent loops, route upstream LLM calls through `chillrewind run` (deterministic SQLite WAL replay + SlopSieve circuit breaker).',
|
|
33
|
+
'5. **Delivery Disclosure:** End non-trivial deliveries with a 1-line disclosure: what was skipped and known limits/trade-offs.',
|
|
31
34
|
'<!-- chill-agent:end -->'
|
|
32
35
|
];
|
|
33
36
|
return lines.join('\n');
|