This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow-steward.git
The following commit(s) were added to refs/heads/main by this push:
new 0e23d9a docs(AGENTS): add whole-tree prek pre-flight gate before
opening a PR (#210)
0e23d9a is described below
commit 0e23d9a86ced298c372465f03a339754fcfad97a
Author: Jarek Potiuk <[email protected]>
AuthorDate: Mon May 18 12:39:43 2026 +0200
docs(AGENTS): add whole-tree prek pre-flight gate before opening a PR (#210)
The repository already mandates `prek install` and per-commit hook
verification ("Verify before every commit (agents and humans
alike)"). That covers most cases, but the commit hook only
inspects files in the *current* commit — issues in files
committed earlier on the branch, or untouched files that pick up
a new lint rule when CI updates, slip past it. A whole-tree
`prek run --all-files` run mirrors what CI executes and surfaces
those regressions locally before the PR round-trip.
Generated-by: Claude Code (Opus 4.7)
---
AGENTS.md | 11 +++++++++++
1 file changed, 11 insertions(+)
diff --git a/AGENTS.md b/AGENTS.md
index 7d2285a..874e00b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -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
