Skip to content

process: mandatory five-row Impact block in every PR and review - #388

Merged
MendixMau merged 3 commits into
masterfrom
process/impact-block
Oct 15, 2026
Merged

MendixMau merged 3 commits into
masterfrom
process/impact-block

Conversation

@MendixMau

Copy link
Copy Markdown
Owner

Direct lane

What changed and why (one paragraph): The maintainer asked for every PR review to state what a change costs. Tonight three PRs were reviewed without anyone stating their process cost: #375 added a human step per re-baseline and #384 adds 1–11 s per exec, and both were found only by chance. This PR adds a five-row Impact block (Process, Dependencies, Context cost, Behaviour, Runtime) to the Direct lane of the PR template. docs/RELEASE-PROCESS.md gets a new §4a: the reviewer confirms each of the five rows against the diff, a missing or estimated Context cost row is a review finding, the Behaviour A/B tiers are spelled out (required / recommended / n/a), and there is a bad/good example row. CONTRIBUTING.md's reviewer checklist points to §4a. No CI check was added, because bin/check-pr-discipline.sh reads the git diff and not the PR body.

Field evidence: process change, not an instrument. The trigger is the 2026-10-15 review batch: #375 and #384, where the costs were found by chance.

  • No client data anywhere in the diff
  • Size cap: 4 files, 41 added lines
  • Test tier reached: T0 plus the mechanical checks below (process/template change, no script touched, so no fixture applies). This PR body is the dry run of the new template.
  • For a new/changed instrument: n/a
  • For a new skill: n/a
  • CHANGELOG.md line appended, crediting the maintainer request
  • New bug entries: n/a

Impact

Row Answer
Process +1 author step per Direct-lane PR (fill 5 rows, run render-routing.sh --check on base and head) and +1 reviewer step (confirm 5 rows). Nothing new blocks in CI; the rule is enforced by review. No new stage artifacts.
Dependencies Shared files touched: none of _common.sh, exec.sh or skill-routing.tsv. Only .github/PULL_REQUEST_TEMPLATE.md, docs/RELEASE-PROCESS.md, CONTRIBUTING.md and CHANGELOG.md. Ordering: any open PR that edits CHANGELOG ## Unreleased or RELEASE-PROCESS §4/§5 may conflict trivially. No new tools or platform assumptions. No new artifact reads.
Context cost 0. bin/render-routing.sh --check gives identical output on base 868b3cb and head: baseline 73,522 words (budget 80,000); stage 5 per role mdl 30,185, review 30,889, gate 22,354, test 21,296. None of the edited files are routed.
Behaviour n/a: no agent-read text. The files are the PR template and contributor/release docs, not skills or agent stubs.
Runtime n/a: no exec, gate or check changed. Each render-routing.sh --check the author now runs takes about 12 s (measured: 12.4 s real).

Checks run on head: bin/render-routing.sh --check (in sync, baseline 73,522 / 80,000), bin/check-scripts.sh (114/114 shell, 22/22 Node), bin/check-portability.sh (clean, 248 files), LEAKGUARD_ALLOW_NO_DENYLIST=1 bin/check-no-client-data.sh (clean, 987 files; name check skipped because there is no denylist), bin/check-pr-discipline.sh (clean).

🤖 Generated with Claude Code

https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw


Generated by Claude Code

Every Direct-lane PR and every review fills Process, Dependencies,
Context cost, Behaviour and Runtime. Context cost is pasted from
bin/render-routing.sh --check on base and head. RELEASE-PROCESS.md §4a
holds the reviewer rule, the A/B requirement tiers and a bad/good
example; CONTRIBUTING.md's reviewer list points there.

No CI check: check-pr-discipline.sh reads the git diff, not the PR body.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
…ile, docs read by agents are not n/a

Independent review of #388: MERGE with four wording fixes, applied here.
- Context cost may be "none: no routed or always-loaded file touched";
  paste render-routing output only when a routed file changes.
- Behaviour: process docs and templates read by review agents are agent-read
  text -> NOT RUN with a reason, never n/a; n/a is for scripts only.
- CONTRIBUTING: the Impact check is its own numbered merge criterion.
- Template says "every Direct-lane PR", matching the CHANGELOG line.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
…ot require the A/B

Applying the block to 11 open PRs marked #273 and #346 "A/B REQUIRED" only
because render-routing added an on-demand row to agent stubs, with Context
cost 0. Say so: that case is NOT RUN with the reason, not required.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
@MendixMau
MendixMau merged commit 484e7ff into master Oct 15, 2026
1 check passed
MendixMau pushed a commit that referenced this pull request Oct 15, 2026
Brings in #385, #388, #389. Clean merge: exec.sh (STOP-row scan, #349),
skills/learned-mdl-preflight.md and CHANGELOG.md auto-merged with both
sides kept; render-routing --check passes without a re-render.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VJgWP5vEoAsNsJYqCDMGNw
@MendixMau
MendixMau deleted the process/impact-block branch October 15, 2026 10:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants