Skip to content

docs(AGENTS): require agents to install + run prek before opening a PR #210

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
potiuk merged 1 commit into from
May 18, 2026
Merged

docs(AGENTS): require agents to install + run prek before opening a PR #210

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
11 changes: 11 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -396,6 +396,17 @@ commit again. **Do not bypass the hooks with `--no-verify`** —
if a hook is failing, fix the underlying issue or update the
hook configuration in the same PR.

**Before opening or updating a pull request, run
`prek run --all-files` (or `prek run --from-ref <base>` against
the PR's base branch) as a hard pre-flight gate.** The
`prek install` git hook fires on each `git commit`, but only
against the files in that commit — issues in files committed
earlier on the branch (or files the current commit didn't
touch) can slip past it. A whole-tree `prek run` mirrors what
CI executes and surfaces those regressions locally before the
PR round-trip, instead of after a CI failure that costs a
round-trip and a reviewer's attention on a mechanical fix.

**Keep the framework snapshot in sync with the project's pin.**
The framework lives at `<adopter-tracker>/.apache-steward/` as a
**gitignored snapshot** that
Expand Down
Loading