Skip to content

Teach AI agents to use pre-commit to pass before committing and pushing #2702

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tatiana merged 2 commits into from
May 19, 2026
Merged

Teach AI agents to use pre-commit to pass before committing and pushing #2702

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f8a6bf0
Require pre-commit to pass before committing and pushing
tatiana May 19, 2026
693c3d9
Update CLAUDE.md
tatiana May 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,12 +63,15 @@ When writing or editing files under `docs/`, follow the Cosmos lightweight style

### Linting and Formatting

Pre-commit runs the configured linters/formatters (e.g., Black (formatter), Ruff (linter), mypy, codespell). See `.pre-commit-config.yaml` for the full list:
**Always run the full pre-commit suite locally and ensure it passes before committing or pushing.** This includes the formatters, linters, type checks, and style checks (`scripts/check_docs_style.py` for `docs/`, configured via `.pre-commit-config.yaml`). The same hooks run in CI; catching failures locally avoids a wasted CI round-trip and a noisy PR history.

```bash
pre-commit run --all-files
```

Individual tools:
Pre-commit's configured tools (Black, Ruff, mypy, codespell, check_docs_style, etc.) are listed in `.pre-commit-config.yaml`.

Individual tools, if you need to iterate on a single one:
```bash
black --line-length 120 cosmos/
ruff check cosmos/
Expand Down