chill-agent 1.2.0 → 1.3.0

package/GUIDE.md

@@ -0,0 +1,47 @@
+# ChillAgent Comprehensive Operational Guide
+
+> Master Negative Filter, Anti-Slop 2.0, and Pragmatic Senior Developer Standard.
+
+---
+
+## What is ChillAgent?
+
+ChillAgent is a dual-core intelligence layer for AI coding assistants that stops two of the most common AI failure modes:
+1. **AI Visual Slop:** Cookie-cutter landing pages with purple gradients, bubbly rounded-3xl cards, generic Lucide-style star icons, and fake metrics.
+2. **AI Architectural Over-Engineering:** Writing 5 classes, factory wrappers, and custom repository interfaces for a simple 10-line routine.
+
+---
+
+## The Core Mechanisms
+
+### 1. The Purpose Test (Visual Craftsmanship)
+Before rendering any gradient, badge, glassmorphic layer, or shadow, ask:
+> *"What specific communicative or domain hierarchy goal does this serve?"*
+If the answer is *"it looks modern"* or *"it fills space"*, delete it immediately.
+
+### 2. The 6-Step Minimalist Execution Ladder (Ponytail Creed)
+1. Does it need to exist? (Skip unrequested features)
+2. Already in this codebase? (Reuse existing house patterns)
+3. Standard library or native platform? (Node stdlib, native CSS/HTML)
+4. Already-installed dependency? (Use `package.json` packages)
+5. Can it be one readable line? (Write the one line)
+6. Minimum working code.
+
+### 3. Intensity Controls
+Switch intensity modes in chat anytime:
+- `/chill lite` — Prototyping mode.
+- `/chill full` — Production default.
+- `/chill ultra` — Maximum minimalism & audit rigor.
+
+### 4. SlopSieve Runtime Pruning & Loop Circuit Breaker
+When running agents through `chillrewind run`:
+- Stale tool outputs older than 4 conversation turns exceeding 1.5KB are pruned middle-out, saving up to 80% context tokens.
+- If an agent calls the exact same tool with identical arguments 3 times consecutively, the circuit breaker halts upstream calls to stop runaway token burn.
+
+### 5. Mandatory Delivery Disclosure
+At the conclusion of every non-trivial technical response, provide:
+```markdown
+---
+**Skipped:** [Deliberately omitted features or abstractions]
+**Risk / Limits:** [Known limits and trigger conditions for upgrading]
+```

package/INSTALL.md

@@ -0,0 +1,78 @@
+# ChillAgent Installation Guide
+
+Choose your agent environment below. ChillAgent natively integrates with every major AI coding assistant.
+
+---
+
+## 1. Zero-Install Execution via NPX (Recommended)
+
+Run directly from any terminal without pre-installing:
+
+```bash
+# Interactive setup wizard
+npx chill-agent
+
+# Codebase anti-slop & over-engineering audit
+npx chill-agent audit
+
+# Automatic remediation (strips emojis, cleans redundant comments, normalizes radius)
+npx chill-agent audit --fix
+
+# Generate a master high-craft DESIGN.md
+npx chill-agent init-design
+
+# Verify installed agent environment hooks
+npx chill-agent doctor
+```
+
+---
+
+## 2. Antigravity (Google / AGY)
+
+Add as an Antigravity plugin or copy pointer:
+```bash
+agy plugin install https://github.com/sann/chill-agent
+```
+Or include the pointer block in `GEMINI.md`:
+```markdown
+<!-- chill-agent:start -->
+## ChillAgent Anti-Slop 2.0 & Pragmatic Senior Dev Standard
+Follow active skills in \`skills/chill-slop/SKILL.md\`.
+<!-- chill-agent:end -->
+```
+
+---
+
+## 3. Claude Code (Anthropic)
+
+Install via Claude Code plugin marketplace:
+```bash
+/plugin marketplace add https://github.com/sann/chill-agent
+/plugin install chill-agent@chill-agent
+```
+Or append pointer to `CLAUDE.md`.
+
+---
+
+## 4. Cursor IDE
+
+ChillAgent installs rules directly into `.cursor/rules/chill-agent.mdc` or `.cursorrules`.
+Activate anytime via `/chill [lite|full|ultra]` in Cursor Composer.
+
+---
+
+## 5. Windsurf (Codeium)
+
+Rules are loaded from `.windsurf/rules/chill-agent.md` or `.windsurfrules`.
+
+---
+
+## 6. OpenAI Codex & OpenCode
+
+Add plugin to `.agents/plugins/marketplace.json` or `.codex-plugin/plugin.json`, or copy `AGENTS.md` to project root.
+
+---
+
+## 7. Cline & Roo Code
+
+Load rules from `.clinerules/chill-agent` or install via `.cline-plugin/plugin.json`.

package/after-install.md

@@ -0,0 +1,23 @@
+# After Install
+
+ChillAgent is now active in your workspace.
+
+## Immediate Commands
+
+- `/chill [lite|full|ultra|off]` — Switch runtime minimalism intensity.
+- `/chill-audit [target]` — Audit diffs and check for over-engineering bloat.
+- `/chill-review [target]` — Review code and verify the shortest readable diff.
+- `/chill-debt` — Identify dead code, unused abstractions, and redundant layers.
+- `/chill-gain` — Measure net lines added vs business capability gained.
+- `/chill-help` — View available commands and active skill configurations.
+
+## Verification
+
+Run the auditor to scan for AI slop and bloat:
+```bash
+npx chill-agent audit
+```
+To launch the live time-travel inspector:
+```bash
+npx chill-agent rewind ui
+```