chill-agent 0.0.0-stage β 1.1.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/LICENSE +21 -0
- package/README.md +99 -2
- package/bin/chill-agent.js +7 -0
- package/package.json +38 -4
- package/skills/chill-slop/SKILL.md +96 -0
- package/skills/chill-slop-code/SKILL.md +45 -0
- package/skills/chill-slop-copywriting/SKILL.md +32 -0
- package/skills/chill-slop-human/SKILL.md +24 -0
- package/skills/chill-slop-mobile/SKILL.md +28 -0
- package/skills/chill-slop-ui/SKILL.md +41 -0
- package/src/auditor.js +229 -0
- package/src/cli.js +250 -0
- package/src/detector.js +102 -0
- package/src/index.js +6 -0
- package/src/installer.js +84 -0
- package/src/presets.js +126 -0
- package/src/prompts.js +192 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 sann
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,100 @@
|
|
|
1
|
-
#
|
|
1
|
+
# ChillAgent (`chill-agent`)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> **The Zero-Bloat Anti-Slop 2.0 Engine & Pragmatic Senior Developer Standard.**
|
|
4
|
+
> Synthesizing the visual craftsmanship of **[anti-slop](https://github.com/miqdadbadjuber/anti-slop)** with the ruthless YAGNI minimalism of **[ponytail](https://github.com/dietrichgebert/ponytail)**.
|
|
5
|
+
|
|
6
|
+
[](https://www.npmjs.com/package/chill-agent)
|
|
7
|
+
[](https://opensource.org/licenses/MIT)
|
|
8
|
+
[](package.json)
|
|
9
|
+
[](https://nodejs.org)
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## β‘ Quickstart
|
|
14
|
+
|
|
15
|
+
Run directly without installing via `npx`:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
# Launch interactive agent setup wizard (Antigravity, Claude, Cursor, Codex, Windsurf)
|
|
19
|
+
npx chill-agent
|
|
20
|
+
|
|
21
|
+
# Scan workspace for AI slop cliches & over-engineering bloat
|
|
22
|
+
npx chill-agent audit
|
|
23
|
+
|
|
24
|
+
# Automatically remediate slop (strip emojis, clean redundant comments, fix radius)
|
|
25
|
+
npx chill-agent audit --fix
|
|
26
|
+
|
|
27
|
+
# Generate a master high-craft DESIGN.md specification
|
|
28
|
+
npx chill-agent init-design
|
|
29
|
+
|
|
30
|
+
# Inspect agent environment health & active hooks
|
|
31
|
+
npx chill-agent doctor
|
|
32
|
+
|
|
33
|
+
# Launch deterministic time-travel debugger & Linear-grade Web Inspector
|
|
34
|
+
npx chill-agent rewind ui
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## π The Synthesis: Anti-Slop + Ponytail (Made Better)
|
|
40
|
+
|
|
41
|
+
ChillAgent is **not** just a list of bans, nor is it just "write less code". It fuses two core engineering philosophies:
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
ββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
45
|
+
β CHILLAGENT β
|
|
46
|
+
βββββββββββββββββββββββββββ¬βββββββββββββββββββββββββ€
|
|
47
|
+
β ANTI-SLOP (Visuals) β PONYTAIL (Logic) β
|
|
48
|
+
βββββββββββββββββββββββββββΌβββββββββββββββββββββββββ€
|
|
49
|
+
β β’ No generic gradients β β’ Smallest diff wins β
|
|
50
|
+
β β’ No pill bubble cards β β’ Native platform 1st β
|
|
51
|
+
β β’ Purpose Test verified β β’ Zero factory bloat β
|
|
52
|
+
β β’ Tabular numbers font β β’ 1-line why comments β
|
|
53
|
+
β β’ Real copy & metrics β β’ Delivery disclosure β
|
|
54
|
+
βββββββββββββββββββββββββββ΄βββββββββββββββββββββββββ
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### The 6-Step Minimalist Execution Ladder
|
|
58
|
+
Take the **first option** that solves the whole task:
|
|
59
|
+
1. **Does it need to exist?** Skip features and configurability nobody asked for.
|
|
60
|
+
2. **Already in this codebase?** Reuse existing helpers, patterns, and house components.
|
|
61
|
+
3. **Standard library or native web API?** Reach for `node:*`, `fetch`, CSS Grid, native `<dialog>`.
|
|
62
|
+
4. **Already-installed dependency?** Use what exists in `package.json`. Never install a package for 10 lines of code.
|
|
63
|
+
5. **Can it be a single readable line?** Write the single line.
|
|
64
|
+
6. **Otherwise:** The minimum code that works reliably.
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## π― Intensity Modes (`/chill [lite|full|ultra]`)
|
|
69
|
+
|
|
70
|
+
- **`lite`**: Prototyping mode. Strips obvious slop gradients while allowing exploratory code.
|
|
71
|
+
- **`full`** *(Default)*: Everyday production engineering. Strict Purpose Test, YAGNI enforcement, standard library first, delivery disclosure.
|
|
72
|
+
- **`ultra`**: High-performance refactoring. Single-file bias, zero external dependencies, absolute shortest diff, aggressive dead-code deletion.
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## π§© 6 Modular Skills (in `./skills/`)
|
|
77
|
+
|
|
78
|
+
1. **`chill-slop` (Master Filter):** Fuses Ponytail YAGNI ladder with Anti-Slop Hard Gates (no purple mesh orbs, no bubbly cards, no unanchored dark mode).
|
|
79
|
+
2. **`chill-slop-code` (Pragmatic Engineering):** The shortest working diff wins, native APIs first, no premature factory classes, no emojis in code.
|
|
80
|
+
3. **`chill-slop-ui` (Visual Engineering):** Precision carbon palette (`#09090B`), 1px hairline borders (`#26262B`), tabular monospace numbers.
|
|
81
|
+
4. **`chill-slop-copywriting` (Domain Voice):** Strips robotic AI buzzwords (*"unleash the power"*, *"supercharge"*, *"seamless"*) in favor of concrete engineering specifications.
|
|
82
|
+
5. **`chill-slop-human` (Ergonomics & A11y):** Enforces 4.5:1 contrast, visible focus rings, 44px touch targets, and accessible ARIA affordances.
|
|
83
|
+
6. **`chill-slop-mobile` (Responsive Systems):** Fluid CSS `clamp()` typography, zero horizontal blowout, and comfortable thumb-reach zone actions.
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## π¨ 5 High-Craft Design System Presets (`npx chill-agent init-design`)
|
|
88
|
+
|
|
89
|
+
Prevent your coding agent from falling into the "sterile blank white" trap:
|
|
90
|
+
- **Linear Carbon Geist:** Deep obsidian canvas, 1px `#26262B` borders, JetBrains Mono, emerald state indicators.
|
|
91
|
+
- **Swiss Neo-Brutal:** High contrast black/white ink, strict 0px border radius, heavy grotesque typography.
|
|
92
|
+
- **Industrial Technical Dossier:** Blueprint data-first layout, slate/steel surfaces, dense telemetry views.
|
|
93
|
+
- **Warm Analog Editorial:** Warm ivory `#FBFBF9` paper, charcoal ink, literary serif headings.
|
|
94
|
+
- **Cyberpunk Micro-Density:** HUD telemetry panels, emerald phosphor text, compact technical toggles.
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## π License
|
|
99
|
+
|
|
100
|
+
MIT Β© [sann](https://github.com/sann)
|
package/package.json
CHANGED
|
@@ -1,6 +1,40 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "chill-agent",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "Zero-bloat Anti-Slop 2.0 Engine & Deterministic Time-Travel Debugger for AI Coding Agents.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"bin": {
|
|
7
|
+
"chill-agent": "bin/chill-agent.js"
|
|
8
|
+
},
|
|
9
|
+
"main": "./src/index.js",
|
|
10
|
+
"scripts": {
|
|
11
|
+
"start": "node ./bin/chill-agent.js",
|
|
12
|
+
"test": "node --test test/*.test.js",
|
|
13
|
+
"audit": "node ./bin/chill-agent.js audit",
|
|
14
|
+
"lint": "node ./bin/chill-agent.js audit"
|
|
15
|
+
},
|
|
16
|
+
"engines": {
|
|
17
|
+
"node": ">=18.0.0"
|
|
18
|
+
},
|
|
19
|
+
"keywords": [
|
|
20
|
+
"anti-slop",
|
|
21
|
+
"ai-agents",
|
|
22
|
+
"design-rules",
|
|
23
|
+
"claude-code",
|
|
24
|
+
"cursor",
|
|
25
|
+
"antigravity",
|
|
26
|
+
"time-travel-debugger",
|
|
27
|
+
"mcp",
|
|
28
|
+
"code-cleanup",
|
|
29
|
+
"accessibility"
|
|
30
|
+
],
|
|
31
|
+
"author": "sann",
|
|
32
|
+
"license": "MIT",
|
|
33
|
+
"files": [
|
|
34
|
+
"bin/",
|
|
35
|
+
"src/",
|
|
36
|
+
"skills/",
|
|
37
|
+
"README.md",
|
|
38
|
+
"LICENSE"
|
|
39
|
+
]
|
|
40
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: chill-slop
|
|
3
|
+
description: "Master Anti-Slop & Pragmatic Senior Dev Standard. Combines ruthless YAGNI minimalism (Ponytail) with uncompromising visual craftsmanship (Anti-Slop). Stops AI agents from generating bloated, generic, purple-glowing slop."
|
|
4
|
+
argument-hint: "[lite|full|ultra|off]"
|
|
5
|
+
license: MIT
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# ChillSlop 2.0: Master Negative Filter & Pragmatic Senior Dev Core
|
|
9
|
+
|
|
10
|
+
> **The Creed:** *"The best code is the code you never wrote. The best design is the interface that gets out of the user's way."*
|
|
11
|
+
> You are a world-class principal design engineer and pragmatic senior developer. You solve the whole problem with the least code and the highest craft.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## 1. The Dual Engine: Anti-Slop + Ponytail Synthesis
|
|
16
|
+
|
|
17
|
+
Every output must pass both filters simultaneously:
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
βββββββββββββββββββββββββββββββββββ βββββββββββββββββββββββββββββββββββ
|
|
21
|
+
β ANTI-SLOP (Craftsmanship) β + β PONYTAIL (Minimalism) β
|
|
22
|
+
β β’ No AI default cliches β β β’ Smallest complete change β
|
|
23
|
+
β β’ Purpose-tested visuals β β β’ Standard library & native API β
|
|
24
|
+
β β’ High-contrast domain identity β β β’ Zero premature abstraction β
|
|
25
|
+
β β’ Real copy & verified metrics β β β’ Shortest readable diff wins β
|
|
26
|
+
βββββββββββββββββββββββββββββββββββ βββββββββββββββββββββββββββββββββββ
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 2. Intensity Modes
|
|
32
|
+
|
|
33
|
+
Control the minimalism & rigor level with `/chill [lite|full|ultra]`:
|
|
34
|
+
|
|
35
|
+
| Level | When to Use | Behavior |
|
|
36
|
+
| :--- | :--- | :--- |
|
|
37
|
+
| **`lite`** | Prototyping & exploratory work | Filters obvious visual slop and bloated dependencies; allows exploratory boilerplate if requested. |
|
|
38
|
+
| **`full`** *(Default)* | Everyday production engineering | Strict Purpose Test, YAGNI enforcement, standard library first, max 10-line helpers, delivery disclosure. |
|
|
39
|
+
| **`ultra`** | High-performance & refactoring | Single-file bias, zero external dependencies, absolute shortest diff, aggressive dead-code deletion. |
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 3. The 6-Step Minimalist Execution Ladder
|
|
44
|
+
|
|
45
|
+
Take the **first option** that completely solves the problem:
|
|
46
|
+
|
|
47
|
+
1. **Does it need to exist?** Skip features, toggles, and configurability nobody asked for. A vague request gets the cleanest core implementation.
|
|
48
|
+
2. **Already in this codebase?** Reuse existing helpers, patterns, and component conventions. Never reinvent a utility already present.
|
|
49
|
+
3. **Standard library or native web API?** Reach for `node:*`, `fetch`, CSS Grid, native dialogs, or standard math before installing an npm module or writing custom wrappers.
|
|
50
|
+
4. **Already-installed dependency?** Use what exists in `package.json`. Never add a new dependency for 10 lines of utility logic.
|
|
51
|
+
5. **Can it be a single readable line?** Write the single line.
|
|
52
|
+
6. **Otherwise:** The absolute minimum code that works reliably.
|
|
53
|
+
|
|
54
|
+
> **Be lazy about the solution, never about the change itself:** Finish every caller, test, fixture, and edge case your change touches. Deletion beats addition.
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## 4. Tier 0: Hard Gates (Non-Negotiable Banned Slop)
|
|
59
|
+
|
|
60
|
+
Instant disqualification if detected in output:
|
|
61
|
+
|
|
62
|
+
### Visual & Architectural Slop
|
|
63
|
+
- **HG-01 (Generic Gradient Orbs):** No saturated purple-to-blue, purple-to-cyan, or glowing radial mesh backgrounds.
|
|
64
|
+
- **HG-02 (Pill Button & Bubble Card Epidemic):** No universal `rounded-3xl` / `rounded-full` cards drowning in heavy 25px drop shadows.
|
|
65
|
+
- **HG-03 (Glassmorphism Overdose):** No stacking `backdrop-blur` on navbars, cards, sidebars, and modals at the same time.
|
|
66
|
+
- **HG-04 (Skeleton Wireframe Previews):** Never put grey placeholder rectangles inside hero mockups as "product screenshots".
|
|
67
|
+
- **HG-05 (Over-Abstraction Bloat):** Never create an AbstractFactory, RepositoryProvider, or 5-layer wrapper around a simple 20-line database or API call.
|
|
68
|
+
- **HG-06 (Unrequested Toggles):** Never add configuration flags, theme pickers, or environment toggles unless explicitly requested.
|
|
69
|
+
|
|
70
|
+
### Copy & Commentary Slop
|
|
71
|
+
- **HG-07 (Emoji Clutter):** No emojis in code comments (`// π Launch rockets`) and no sparkles (`β¨`) in marketing copy.
|
|
72
|
+
- **HG-08 (Robotic AI Buzzwords):** Strip *"unleash the power"*, *"seamlessly integrate"*, *"supercharge your workflow"*, *"next-generation"*, and *"game-changer"*.
|
|
73
|
+
- **HG-09 (Fake Social Proof):** No synthetic testimonials, fake user headshots, or unverified statistics (*"99.9% customer happiness"*).
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## 5. The Liveliness & Craftsmanship Standard
|
|
78
|
+
|
|
79
|
+
Removing slop does not mean building an empty, sterile gray box. Inject **domain-specific liveliness**:
|
|
80
|
+
|
|
81
|
+
- **Typography as Architecture:** High-contrast pairing (grotesque or serif display header + precision monospace for data and numbers).
|
|
82
|
+
- **Hairline Precision:** Build depth using distinct background shades (`#09090B` canvas β `#111114` panel β `#18181C` interactive) and 1px borders (`#26262B`), not muddy box shadows.
|
|
83
|
+
- **Monochrome Foundation:** 90% of the screen is stark carbon or crisp light; color is reserved strictly for semantic state (Emerald for success/replay, Amber for warning/pruned, Rose for error/loop-break).
|
|
84
|
+
- **Tabular Monospace Discipline:** Timestamps, IDs, latency, financial values, and counters must use `ui-monospace` or `font-variant-numeric: tabular-nums`.
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## 6. The Mandatory Delivery Disclosure
|
|
89
|
+
|
|
90
|
+
At the end of **every** code delivery or refactor, provide a concise 1-2 line disclosure:
|
|
91
|
+
|
|
92
|
+
```markdown
|
|
93
|
+
---
|
|
94
|
+
**Skipped:** [What features, boilerplate, or abstractions you deliberately omitted]
|
|
95
|
+
**Risk / Limits:** [Known trade-offs, edge-case limitations, or when the user should upgrade]
|
|
96
|
+
```
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: chill-slop-code
|
|
3
|
+
description: "Pragmatic Senior Dev Code Standard. Eliminates over-engineering, premature abstractions, useless boilerplate, redundant AI comments, and emoji docstrings. Favors standard libraries and the shortest working diff."
|
|
4
|
+
license: MIT
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# ChillSlop Code: Pragmatic Senior Engineering
|
|
8
|
+
|
|
9
|
+
> *"Any fool can write code that a computer can understand. Good programmers write code that humans can understand with the least reading."*
|
|
10
|
+
|
|
11
|
+
## 1. The Shortest Working Diff Wins
|
|
12
|
+
- **Deletion Beats Addition:** Every line of code added is a liability. If you can solve an issue by deleting dead code or consolidating logic, delete it.
|
|
13
|
+
- **No Speculative Abstraction:** Never build generic interfaces, custom event buses, factory patterns, or wrapper types for code that is only called in one place.
|
|
14
|
+
- **Native Platform First:**
|
|
15
|
+
- Node.js: Prefer `node:sqlite`, `node:http`, `node:crypto`, `node:util` `parseArgs` over adding heavy external packages.
|
|
16
|
+
- Browser: Prefer native CSS Grid, flexbox, `<dialog>`, `URLSearchParams`, and `fetch` over external utility libraries.
|
|
17
|
+
- **Single-File Bias:** Unless an architectural boundary is strictly required, keep closely coupled logic in the same module rather than fragmenting across 8 micro-files.
|
|
18
|
+
|
|
19
|
+
## 2. Bug Fix Protocol
|
|
20
|
+
- **Trace the Roots:** Before modifying a function, grep every single caller in the workspace. Fix the root cause once at the source rather than patching each call site.
|
|
21
|
+
- **Preserve Safety:** Code that is moved or consolidated must retain its error boundaries, type validations, and security checks.
|
|
22
|
+
|
|
23
|
+
## 3. Strict Commenting Rules
|
|
24
|
+
- **Document the "WHY", never the "WHAT":**
|
|
25
|
+
- *Banned Slop:*
|
|
26
|
+
```typescript
|
|
27
|
+
// Iterate through items and filter active ones
|
|
28
|
+
const active = items.filter(x => x.active);
|
|
29
|
+
```
|
|
30
|
+
- *Clean:*
|
|
31
|
+
```typescript
|
|
32
|
+
const active = items.filter(x => x.active);
|
|
33
|
+
```
|
|
34
|
+
- *Valuable:*
|
|
35
|
+
```typescript
|
|
36
|
+
// PRAGMA synchronous = NORMAL is safe with WAL mode and prevents 40ms disk sync stalls
|
|
37
|
+
db.exec(`PRAGMA synchronous = NORMAL;`);
|
|
38
|
+
```
|
|
39
|
+
- **Zero Emojis in Source Code:** Never put emojis in comments, docstrings, console logs, or git commits.
|
|
40
|
+
- **Explicit Shortcuts:** If you take a pragmatic shortcut, mark it explicitly:
|
|
41
|
+
`// shortcut: <known limit>, <when to upgrade>`
|
|
42
|
+
|
|
43
|
+
## 4. Lazy Self-Checks
|
|
44
|
+
- Non-trivial logic (parsers, state machines, financial math, security checks) must include at least one compact assert or unit test.
|
|
45
|
+
- Trivial one-liners require no test boilerplate.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: chill-slop-copywriting
|
|
3
|
+
description: "Authentic Domain Voice & Minimalist Copywriting 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
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# ChillSlop Copywriting: Authentic Domain Voice
|
|
8
|
+
|
|
9
|
+
> *"Write with the precision of an engineer and the brevity of an editor."*
|
|
10
|
+
|
|
11
|
+
## 1. Zero AI Buzzwords & Cliches
|
|
12
|
+
Strip these phrases immediately:
|
|
13
|
+
- *"Unleash the power of..."* β Name the exact feature and its concrete function.
|
|
14
|
+
- *"Seamless integration / Effortless workflow"* β State the exact protocol (*"Installs via stdio JSON-RPC in 1 command"*).
|
|
15
|
+
- *"Supercharge your team / Game-changer / Next-generation"* β Give verified latency or throughput figures.
|
|
16
|
+
- *"Delve into / Dive deep / Look no further"* β Start directly with the technical instruction.
|
|
17
|
+
- *"Robust, scalable, and cutting-edge"* β Specify uptime, architecture, or benchmark.
|
|
18
|
+
- *"Empower developers to..."* β State the developer's exact action.
|
|
19
|
+
|
|
20
|
+
## 2. The Specificity Mandate
|
|
21
|
+
- Replace vague assertions with concrete specifications:
|
|
22
|
+
- *Slop:* "Lightweight tool that saves lots of tokens and makes coding super fast."
|
|
23
|
+
- *Clean:* "0ms deterministic SQLite proxy that prunes stale tool outputs over 1.5KB."
|
|
24
|
+
- Never generate synthetic customer quotes, fake TechCrunch badges, or bogus claims (*"99.9% satisfaction"*). If verified proof does not exist, omit social proof entirely.
|
|
25
|
+
|
|
26
|
+
## 3. Microcopy & Interface Verbs
|
|
27
|
+
- **Action Verbs on Buttons:** Imperative verb + direct object:
|
|
28
|
+
- Prefer: `Fork Session`, `Export JSON`, `Connect Database`, `Copy API Key`.
|
|
29
|
+
- Avoid: `Submit`, `Click Here`, `Get Started Now`, `Experience Magic`.
|
|
30
|
+
- **Honest Error Messages:** State what broke, why it broke, and the exact resolution command.
|
|
31
|
+
- *Slop:* "Oops! Something went wrong! Please try again later."
|
|
32
|
+
- *Clean:* "Upstream API timeout (504 Gateway Timeout) on `api.anthropic.com`. Verify your network or re-run with `chill-agent run --port 8788`."
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: chill-slop-human
|
|
3
|
+
description: "Ergonomics, Human Factors & Accessibility Standard. Guarantees WCAG AA 4.5:1 contrast, visible focus rings, 44px touch targets, and zero-barrier keyboard navigation."
|
|
4
|
+
license: MIT
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# ChillSlop Human: Ergonomics & Accessibility
|
|
8
|
+
|
|
9
|
+
> *"Accessibility is not a feature; it is the baseline of professional craftsmanship."*
|
|
10
|
+
|
|
11
|
+
## 1. Contrast & Legibility
|
|
12
|
+
- **WCAG AA Minimum Contrast:** Text and interactive elements must maintain at least `4.5:1` contrast ratio against their immediate background (`3:1` for bold text >= 18pt).
|
|
13
|
+
- **No Low-Contrast Gray-on-Gray Slop:** Never use `#71717A` text on `#18181B` backgrounds for critical body copy. Reserve muted gray exclusively for secondary metadata labels.
|
|
14
|
+
|
|
15
|
+
## 2. Keyboard & Focus Management
|
|
16
|
+
- **Visible Focus Rings:** Every button, input, anchor, and clickable div must render a clear, unclipped focus indicator:
|
|
17
|
+
`outline: 2px solid var(--focus-ring); outline-offset: 2px;`
|
|
18
|
+
Never set `outline: none` without a high-visibility replacement.
|
|
19
|
+
- **Escape Key Interception:** All modals, drawers, and overlay dialogs must close immediately on `Escape` keypress and restore focus to the triggering element.
|
|
20
|
+
- **Logical Tab Order:** Ensure the DOM tab order matches visual layout. Never jump focus unexpectedly across the viewport.
|
|
21
|
+
|
|
22
|
+
## 3. Touch Targets & Affordances
|
|
23
|
+
- Interactive touch targets on mobile and touch-enabled devices must measure at least `44x44px` (or `48x48px` for primary controls).
|
|
24
|
+
- Every icon button lacking visible text must include an unambiguous `aria-label` attribute (e.g. `<button aria-label="Close dialog">`).
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: chill-slop-mobile
|
|
3
|
+
description: "Mobile & Responsive Engineering Standard. Fluid CSS clamp typography, zero horizontal blowout, and comfortable thumb-reach zone actions without complex layout bloat."
|
|
4
|
+
license: MIT
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# ChillSlop Mobile: Responsive Engineering
|
|
8
|
+
|
|
9
|
+
> *"A responsive design works everywhere by default, not through 50 media query overrides."*
|
|
10
|
+
|
|
11
|
+
## 1. Zero Horizontal Overflow
|
|
12
|
+
- The viewport must never produce accidental horizontal scrollbars. Eliminate protruding widths and rigid pixel bounds.
|
|
13
|
+
- Tables and wide code views must sit inside cleanly scrollable wrappers:
|
|
14
|
+
`overflow-x: auto; -webkit-overflow-scrolling: touch;`
|
|
15
|
+
|
|
16
|
+
## 2. Fluid Typography & Modular Scale
|
|
17
|
+
- Avoid massive static header sizes on mobile (`font-size: 72px` breaking mobile screens).
|
|
18
|
+
- Use CSS `clamp()` for fluid scaling:
|
|
19
|
+
```css
|
|
20
|
+
h1 {
|
|
21
|
+
font-size: clamp(2rem, 5vw + 1rem, 3.75rem);
|
|
22
|
+
line-height: 1.1;
|
|
23
|
+
}
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## 3. Thumb-Zone Optimization
|
|
27
|
+
- Primary navigation and destructive or frequent actions on mobile should sit within the comfortable bottom thumb-reach zone.
|
|
28
|
+
- Sticky bottom action bars on mobile must respect `env(safe-area-inset-bottom)` to prevent clipping against home indicators.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: chill-slop-ui
|
|
3
|
+
description: "High-Craft Visual Engineering & Minimalist UI Standard. Enforces Linear/Geist/Raycast monochrome discipline, purposeful typography, and clean semantic states while eliminating AI slop gradients and pill cards."
|
|
4
|
+
license: MIT
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# ChillSlop UI: High-Craft Visual Engineering
|
|
8
|
+
|
|
9
|
+
> *"Good design is as little design as possible. Less, but better β because it concentrates on the essential aspects."*
|
|
10
|
+
|
|
11
|
+
## 1. Palette & Surface Architecture
|
|
12
|
+
- **Reject the Purple/Cyan Default:** Saturated violet-to-cyan mesh gradients are banned.
|
|
13
|
+
- **Surface Elevation Hierarchy:** Build visual depth via distinct background shades and hairline borders, not muddy shadows:
|
|
14
|
+
- Base Canvas: `#09090B` (Deep Carbon)
|
|
15
|
+
- Secondary Panel: `#101014`
|
|
16
|
+
- Interactive Elevated: `#16161C`
|
|
17
|
+
- Hover Surface: `#1E1E26`
|
|
18
|
+
- Hairline Border: `1px solid #26262E`
|
|
19
|
+
- **Monochrome Foundation:** Build 90% of the UI in monochrome (carbon, zinc, white). Limit color strictly to semantic roles:
|
|
20
|
+
- Emerald (`#10B981`): Success, verified cache hits, live connectivity.
|
|
21
|
+
- Amber (`#F59E0B`): Pruned content, warnings, pending state.
|
|
22
|
+
- Rose (`#F43F5E`): Circuit breakers, errors, destructive actions.
|
|
23
|
+
- Indigo (`#818CF8`): Branched sessions, active tabs, navigation anchors.
|
|
24
|
+
|
|
25
|
+
## 2. Geometry & Spacing
|
|
26
|
+
- **Border Radius Discipline:**
|
|
27
|
+
- Micro badges, tags, code chips: `4px`
|
|
28
|
+
- Buttons, inputs, dropdown items: `6px`
|
|
29
|
+
- Modals, panels, code containers: `8px`
|
|
30
|
+
- Maximum outer containers: `12px`
|
|
31
|
+
- **Ban:** Universal `rounded-2xl` and `rounded-3xl` cards.
|
|
32
|
+
- **Rhythm Over Magic Numbers:** Use strict modular spacing: `4px`, `8px`, `12px`, `16px`, `24px`, `32px`, `48px`, `64px`.
|
|
33
|
+
|
|
34
|
+
## 3. Component Architecture & Density
|
|
35
|
+
- **Asymmetric Density:** Avoid the clichΓ© 3 identical feature cards with centered icons and 2 lines of lorem ipsum. Use real data tables, inline previews, and asymmetric layouts.
|
|
36
|
+
- **Tabular Monospace Metrics:** All numbers, counters, latencies, timestamps, and hashes must use `ui-monospace`, `JetBrains Mono`, or `font-variant-numeric: tabular-nums` to eliminate layout jitter.
|
|
37
|
+
- **Affordance Clarity:** Interactive elements must have visible hover states, clear pressed states, and distinct disabled opacity (`0.45` with `cursor: not-allowed`).
|
|
38
|
+
|
|
39
|
+
## 4. Animation & Motion
|
|
40
|
+
- Fast, purposeful, non-distracting motion: `duration: 120ms` to `180ms`, easing `cubic-bezier(0.16, 1, 0.3, 1)`.
|
|
41
|
+
- Motion is strictly spatial (drawers sliding in from anchor, dropdown expansion). Never animate elements just to show off CSS transitions.
|