PROJ004infoPro

beta-dependencies

Pre-release dependency may have stability issues

Applies to: JSON

Why this matters

Beta, alpha, RC, and canary versions may have breaking changes, undiscovered bugs, or missing security patches. For production applications, prefer stable releases unless the feature is critical and you're prepared to handle instability.

Catch it before it ships

pip install stablestack # or: npx stablestackstablestack # scans your project, PROJ004 includedstablestack explain PROJ004

PROJ004 is part of the Pro rule set. See pricing — the free tier ships 24 checks with no signup.

False positive in your codebase? Suppress a single line with # noqa: PROJ004

More Project Setup checks

PROJ001

missing-ai-context-file

Projects edited by AI assistants should ship a context file (CLAUDE.md, AGENTS.md, .cursorrules, or equivalent)

PROJ002

missing-git

Projects should use git for version control

PROJ003

pyright-config

Project should have a pyright configuration with sensible defaults.

PROJ005

gitignored-claude-md

CLAUDE.md should not be gitignored — it belongs in version control.

PROJ006

firm-alias-commit-author

Commits are authored under a firm or team alias instead of a specific person

PROJ007

low-test-coverage-ratio

Codebase has a large amount of hand-written source code but very few automated tests

PROJ008

macos-fork-safety-missing

Shell script starts gunicorn/uvicorn/flask with reload but doesn't export OBJC_DISABLE_INITIALIZE_FORK_SAFETY — macOS devs will see 'Python quit unexpectedly' popups on every worker reload.