rsyslog/.agent/skills/rsyslog_pr_babysitting
Rainer Gerhards 2b2fcd5ef5
tests: document diagnostic oracle expectations
Why: Test assertions should prove the observable behavior operators rely
on, not just that rsyslogd wrote a message to its process streams.

Impact: Clarifies test-authoring and babysitting guidance for rsyslog
diagnostics.

Before/After: Tests could use stdout/stderr oracles without a clear
exception; guidance now prefers configured rsyslog output destinations
after synchronized shutdown.

Technical Overview: Add the authoritative rule to tests/AGENTS.md.
Point rsyslog_test at that rule when explaining test oracle
documentation. Add a review-time reminder to rsyslog_pr_babysitting so
PR feedback catches weak stdout/stderr diagnostic oracles. Exceptions
remain allowed when the tested behavior is process output or
configuration is not usable yet, but they must be documented in the test
header.

With the help of AI-Agents: OpenAI Codex
2026-05-21 16:58:31 +02:00
..