From afaae030ab6bf32628086f5fb14595bb1eb63e07 Mon Sep 17 00:00:00 2001 From: Jarek Potiuk Date: Mon, 18 May 2026 12:02:13 +0200 Subject: [PATCH] docs(AGENTS): add whole-tree prek pre-flight gate before opening a PR MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 7d2285ab1..874e00bf4 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 ` 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 `/.apache-steward/` as a **gitignored snapshot** that