lint

Lint

Role

Auto-detect the project's formatters and linters from stack-marker files and run them — optionally scoped to backend or frontend, optionally in --fix mode.

Hard Rules

• Run the formatter before the linter for each stack (format first, then check).
• Prefer a Makefile lint / fmt target over the raw tool when one exists — it may carry project-specific setup.
• Run only the commands in the Step 2 table (and the Step 4 --fix variants); never invent linters, flags, or tools not listed there.
• Treat --fix as a modifier combinable with any scope, not as a scope of its own.
• --fix rewrites files in place — apply it only to the Step 4 format and auto-fix commands, never to check-only commands (go vet, tsc --noEmit, mypy, flake8).
• Report every detected in-scope linter, including PASS and unavailable ones; one block per detected in-scope linter.
• Default to scope all for empty or unrecognized input — never guess a narrower scope.

Step 1 — Parse Arguments

Read the request and derive two independent values from it. Scope and fix are orthogonal: any scope may carry --fix.

$ARGUMENTS

• scope = the first bare token equal to backend, frontend, or all. Empty input or any unrecognized token → all.
• fix = true if the token --fix appears anywhere in the input, else false.

Done-when: scope is exactly one of backend / frontend / all, and fix is true or false.

Step 2 — Detect Linters

Scan the project for stack markers and map each present marker to its commands. Detect with Bash only: test -f <marker> for files, grep -qF '<section>' pyproject.toml for a config section (fixed-string -F so the [...] in section names like [tool.ruff] is matched literally, not as a regex character class), command -v <tool> for a tool on PATH.

Marker	Format Command	Lint Command	Stack
go.mod	gofmt -w .	go vet ./...	Go
go.mod + golangci-lint in PATH	gofmt -w .	golangci-lint run	Go (extended)
package.json + .eslintrc* / eslint.config.*	—	npx eslint .	ESLint
package.json + tsconfig.json	—	npx tsc --noEmit	TypeScript
package.json + prettier config (.prettierrc*, prettier.config.*, or a prettier key in package.json)	npx prettier --write .	npx prettier --check .	Prettier
pyproject.toml + [tool.ruff]	ruff format .	ruff check .	Python (ruff)
pyproject.toml + [tool.black]	black .	—	Python (black)
pyproject.toml + [tool.flake8] / setup.cfg	—	flake8	Python (flake8)
pyproject.toml + [tool.mypy]	—	mypy .	Python (mypy)
Cargo.toml	cargo fmt	cargo clippy -- -D warnings	Rust
Makefile with lint target	—	make lint	Makefile
Makefile with fmt target	make fmt	—	Makefile