v1.0.0 — onerules ai + Smart Merge

v1.0.0 🎉

onerules ai — Project-Specific Rules

The killer feature. Generates a prompt that you feed to your existing AI tool (Claude Code, Cursor, ChatGPT). The AI — which already has your codebase in context — produces rules specific to YOUR project.

onerules ai --copy     # Copy prompt to clipboard → paste into your AI
onerules ai -o prompt.md  # Save to file
onerules ai            # Print to stdout

No API keys needed. Uses whatever AI you already have open.

onerules --merge — Smart Merge

Adds missing rules to existing files without overwriting project-specific content:

onerules --merge       # Append new rules to existing CLAUDE.md

Two Levels of Rules

• Level 1: onerules — instant, offline, stack-aware anti-slop rules
• Level 2: onerules ai — project-specific rules via your existing AI

Full Feature Set

10 commands  •  4 modes  •  12 AI tools  •  23 frameworks  •  25 libraries
onerules, ai, doctor, init, inspect, update, monorepo, diff, --merge, --help
--strict, --minimal, --merge, --force
35 tests  •  CI on Node 18/20/22

Install

npm i -g @blackforge/onerules
onerules doctor   # Score your existing rules
onerules          # Generate anti-slop rules
onerules ai --copy  # Get project-specific rules from your AI

v0.8.0 — Doctor, Monorepo, 25 Library Rules

New Commands

onerules doctor

Scores your existing rule files 0-100. Detects 12 weak patterns and suggests anti-slop replacements:

  CLAUDE.md (Claude Code) — Score: 14/100
    ⚠ "Follow best practices" is too vague — AI ignores it
      → Replace with specific anti-patterns
    ⚠ "Write clean code" is meaningless to an AI
      → Replace with concrete rules
    ✗ Missing: DO NOT rules
    ✗ Missing: Security rules

onerules monorepo

Detects workspaces (pnpm, yarn, npm, turbo, nx) and generates per-workspace rules with workspace-specific stack detection.

3 New Library Rules

• Three.js — dispose GPU resources, InstancedMesh, no render-loop allocation
• Playwright — use locators not selectors, no waitForTimeout
• Cypress — use data-cy, no cy.wait(5000), no async/await mixing

25 total libraries with specific anti-slop rules.

Install

npm i -g @blackforge/onerules
onerules doctor  # Score your existing rules
onerules         # Generate anti-slop rules

v0.7.0 — Init Wizard, Strict Mode, 22 Library Rules

What's New

Interactive Setup

• onerules init — beautiful interactive wizard with tool selection, stack preview, and confirmation

Rule Modes

• --strict — extra aggressive rules (max function length, no default exports, mandatory regression tests)
• --minimal — base anti-slop rules only, skip framework/library details
• Default: 1190 rules | Strict: 1394 | Minimal: 530

Stack-Aware Library Rules

22 libraries with specific anti-slop rules:
Prisma, Drizzle, Zod, tRPC, Tailwind CSS, React Query, Zustand, Redux Toolkit, Radix UI, Framer Motion, Stripe, NextAuth, Lucia, Mongoose, SQLAlchemy, Pydantic, Celery, Redis, Socket.io, GraphQL, Jotai

New Commands

• onerules inspect — shows what was detected and which rules will apply
• onerules init — interactive setup wizard

More Coverage

• 12 AI tools — added Kiro (AWS) and Continue
• 23 frameworks — added Svelte, Actix, Tauri, Electron, React Native
• .onerulesrc — custom rules that survive updates
• .gitignore awareness — warns about ignored files

Quality

• 30 tests across 4 test files
• GitHub Actions CI on Node 18/20/22
• Before/after comparison GIFs in README

Install

npm i -g @blackforge/onerules
onerules