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 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
- # Temporary Holding Version
1
+ # ChillAgent (`chill-agent`)
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
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
+ [![NPM Version](https://img.shields.io/npm/v/chill-agent.svg?style=flat&color=emerald)](https://www.npmjs.com/package/chill-agent)
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
8
+ [![Dependencies](https://img.shields.io/badge/dependencies-0-success.svg)](package.json)
9
+ [![Node.js: >=18.0.0](https://img.shields.io/badge/node-%3E%3D18.0.0-emerald.svg)](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)
@@ -0,0 +1,7 @@
1
+ #!/usr/bin/env node
2
+ import { runCli } from '../src/cli.js';
3
+
4
+ runCli().catch((err) => {
5
+ console.error(err);
6
+ process.exit(1);
7
+ });
package/package.json CHANGED
@@ -1,6 +1,40 @@
1
1
  {
2
2
  "name": "chill-agent",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
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.