cli

create-stackrules

One command to enforce clean architecture in any codebase, any language.

Usage

Scan any codebase (any language)

npx create-stackrules clean

Works on JavaScript, TypeScript, Python, Go, Java, Ruby, Rust, Kotlin, PHP, C#, Swift.

Scans every source file, finds architecture violations, generates a markdown prompt you paste into Claude Code, Cursor, or any AI chat. The AI fixes everything.

  StackRules Clean

  Found 11 source files
    python: 11 files

  Found 11 violation(s):
    File too complex: 3
    Raw SQL query: 7
    Missing logging in service: 1

  Cleanup prompt saved to stackrules-cleanup.md

Add to JS/TS project (ESLint integration)

npx create-stackrules inject

This command:

1. Detects your stack (Next.js, Supabase, Stripe, Express, etc.)
2. Installs eslint-plugin-stackrules
3. Patches your existing ESLint config (keeps your org rules intact)
4. Creates .stackrules.json for org-level customization
5. Adds lint scripts to package.json

Then run npx eslint . for real-time errors in VSCode.

Scaffold new project

npx create-stackrules init

What it catches

Regardless of language:

• Service imports in wrong places — database, payment, email, AI SDKs imported outside services/
• Missing logging — service files without structured logging
• Raw SQL — queries that should use an ORM
• Lint suppression — eslint-disable, # noqa, nolint, @SuppressWarnings
• Complex files — 200+ line files that should be split
• Route/controller bloat — handlers with direct DB calls and no logging

Supported languages

Language	Extensions	Import detection	Logger detection
JavaScript/TypeScript	.js .jsx .ts .tsx	import/require	console, winston, pino
Python	.py	import/from	logging, logger, print
Go	.go	import	log, zap, logrus
Java	.java	import	Logger, LOG
Ruby	.rb	require	logger, Rails.logger
Rust	.rs	use/extern crate	log, tracing
Kotlin	.kt	import	logger, Log
PHP	.php	use/require_once	Log, error_log
C#	.cs	using	(basic)
Swift	.swift	import	(basic)

License

MIT