PROJ005warningFree tier

gitignored-claude-md

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

Applies to: Project-level

Why this matters

CLAUDE.md provides essential project context for AI assistants. When it's gitignored, every developer has to recreate it locally, instructions drift between machines, and new team members get no AI context at all. Check it into version control so the whole team shares the same AI onboarding.

Catch it before it ships

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

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

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.

PROJ004

beta-dependencies

Pre-release dependency may have stability issues

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.