You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The GitHub Workflow standard (pr-standard.md §"Admission: T0 or a pull request") admits exactly two
classes: a T0 direct commit or a pull request, "no third tier and no repository-configurable middle
ground". T0 is a conjunctive predicate whose condition 1 requires every hunk to be a spelling, grammar,
punctuation, or reflow correction, so a routine Agent Handoff closeout — rewriting state.md, appending
a session-log row, retiring a TODO item — can never qualify.
The consequence, observed twice in this repository (#216 on 2026-08-31, and a second draft on
2026-09-01 that the operator stopped), is that session bookkeeping gets its own PR. Agent Handoff
documents are transient agent-side state; a PR per closeout pollutes PR history with nonsense and
adds ceremony to every session end. This repository already carved the exemption into its own CLAUDE.md / AGENTS.md (d5792907), but a consumer-side override is exactly the "repository-
configurable middle ground" the standard forbids — the standard itself must own the rule.
Scope
Amend the github-workflow package so that Agent Handoff documents always admit by direct commit,
regardless of the T0 predicate:
pr-standard.md: define a third admission class (or a standing exemption from the T0 predicate)
for handoff surfaces, and state its trailer or commit-message convention so a git log audit can
still enumerate direct admissions.
Default the exempt path set to the agent-handoff standard's owned surfaces — docs/handoff/**, docs/STATUS.md, docs/TODO.md — and decide whether policy.toml may extend it.
The managed AGENTS.md/CLAUDE.md instruction block and the skill's decision procedures name the
exemption, so a session does not rediscover it.
Cut the payload version and ship it; reconcile this repository and remove the hand-written carve-out
from d5792907 once the managed block carries it.
Out of scope
Weakening T0 for anything other than handoff surfaces; changing which files the agent-handoff standard
owns.
Acceptance criteria
A closeout that touches only handoff surfaces is a permitted direct commit under the standard's own
text, with no Workflow-Admission: T0 misclassification required.
A commit that mixes a handoff edit with any non-exempt file is still governed by the PR rule, and the
standard says so explicitly.
The exemption is discoverable from the managed instruction block alone, without loading the skill.
All predecessors stay byte-immutable; project-standards validate and the reconcile check pass here
after adoption.
Constraints
Payload bytes are immutable after publication, so this is a new package version. The agent-handoff
standard, not github-workflow, is the source of truth for which paths are handoff surfaces; reference
it rather than duplicating the list if the packaging allows.
Verification
Reconcile this repository onto the new version; confirm the managed block states the exemption and
that the hand-written carve-out can be deleted without a CP-MODIFIED-MANAGED or coherence finding.
Evidence / references
.agents/skills/github-workflow/references/pr-standard.md — two-class admission text and T0 predicate.
Context
The GitHub Workflow standard (
pr-standard.md§"Admission: T0 or a pull request") admits exactly twoclasses: a T0 direct commit or a pull request, "no third tier and no repository-configurable middle
ground". T0 is a conjunctive predicate whose condition 1 requires every hunk to be a spelling, grammar,
punctuation, or reflow correction, so a routine Agent Handoff closeout — rewriting
state.md, appendinga session-log row, retiring a TODO item — can never qualify.
The consequence, observed twice in this repository (#216 on 2026-08-31, and a second draft on
2026-09-01 that the operator stopped), is that session bookkeeping gets its own PR. Agent Handoff
documents are transient agent-side state; a PR per closeout pollutes PR history with nonsense and
adds ceremony to every session end. This repository already carved the exemption into its own
CLAUDE.md/AGENTS.md(d5792907), but a consumer-side override is exactly the "repository-configurable middle ground" the standard forbids — the standard itself must own the rule.
Scope
Amend the github-workflow package so that Agent Handoff documents always admit by direct commit,
regardless of the T0 predicate:
pr-standard.md: define a third admission class (or a standing exemption from the T0 predicate)for handoff surfaces, and state its trailer or commit-message convention so a
git logaudit canstill enumerate direct admissions.
docs/handoff/**,docs/STATUS.md,docs/TODO.md— and decide whetherpolicy.tomlmay extend it.AGENTS.md/CLAUDE.mdinstruction block and the skill's decision procedures name theexemption, so a session does not rediscover it.
from
d5792907once the managed block carries it.Out of scope
Weakening T0 for anything other than handoff surfaces; changing which files the agent-handoff standard
owns.
Acceptance criteria
text, with no
Workflow-Admission: T0misclassification required.standard says so explicitly.
project-standards validateand the reconcile check pass hereafter adoption.
Constraints
Payload bytes are immutable after publication, so this is a new package version. The agent-handoff
standard, not github-workflow, is the source of truth for which paths are handoff surfaces; reference
it rather than duplicating the list if the packaging allows.
Verification
Reconcile this repository onto the new version; confirm the managed block states the exemption and
that the hand-written carve-out can be deleted without a
CP-MODIFIED-MANAGEDor coherence finding.Evidence / references
.agents/skills/github-workflow/references/pr-standard.md— two-class admission text and T0 predicate.d5792907— this repository's interim carve-out inCLAUDE.md/AGENTS.md.