Skip to content

docs: require runner name on every agent comment - #41

Merged
glennfaison merged 1 commit into
mainfrom
feature/36-record-runner-in-agent-comments
Oct 25, 2026
Merged

glennfaison merged 1 commit into
mainfrom
feature/36-record-runner-in-agent-comments

Conversation

@glennfaison

Copy link
Copy Markdown
Owner

Summary

Debugging triage and other agent runs is hard when comments do not identify which runner produced them.

Changes

  • references/handoff.md: require **Runner:** $runner (or equivalent) on every outcome, handoff, triage notes, and escalation comment; add Runner to the contents table for Shepherding and Reviewing handoffs.
  • references/log.md: restate that the YAML runner key and the prose **Runner:** line are required, and point issue/PR comments at the handoff rule.

Evidence / verification

  • Templates and tables updated; log already required runner in the machine-readable header — this makes the rule consistent across all agent-authored comments.

ADR check

No conflict with existing ADRs.

Closes #36.

Debugging triage and handoff comments is hard when the runner is not
identified. Update handoff.md so every outcome, handoff and escalation
comment records the runner. Log templates already require it; restate
the rule for clarity.

Closes #36.
@glennfaison
glennfaison merged commit 43abffc into main Oct 25, 2026
2 checks passed
@glennfaison
glennfaison deleted the feature/36-record-runner-in-agent-comments branch October 25, 2026 22:33
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.

All agent comments must record the runner

1 participant