PROJ002warningPro

missing-git

Projects should use git for version control

Applies to: Project-level

Why this matters

Git provides version history, collaboration features, and backup for your code. Without version control, you can't track changes, collaborate safely, or recover from mistakes. It's essential for any serious project.

Catch it before it ships

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

PROJ002 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: PROJ002

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)

PROJ003

pyright-config

Project should have a pyright configuration with sensible defaults.

PROJ004

beta-dependencies

Pre-release dependency may have stability issues

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.