-
Notifications
You must be signed in to change notification settings - Fork 263
Closed
Labels
Description
Objective
Strengthen documentation and examples for the noop safe-output tool, making it explicit that noop must be called when the agent determines no action is needed.
Context
From Agent Persona Exploration discussion #18026:
Strengthen
noopdocumentation — Make explicit thatnoopmust be invoked when the agent determines no action is needed; this is the #1 runtime failure mode for safe-output workflows.
The ci-doctor analysis confirms that missing noop calls is the most common cause of safe-output failures.
Approach
- Review current
noopdocumentation indocs/and identify gaps - Update workflow prompt templates/examples to always include explicit
noopinstructions, e.g.:- "If no action is needed, call
noopwith a message explaining why" - Add a decision tree or checklist pattern to workflow prompts
- "If no action is needed, call
- Add a warning/note in the safe-outputs documentation section
- Review
.github/workflows/*.mdexample workflows and ensure each one includes explicitnoopguidance in its prompt - Consider adding a linting/validation check that warns when a workflow prompt doesn't mention
noop
Files to Modify
docs/— Add/update noop guidance in safe-outputs section.github/workflows/*.md— Ensure all example workflows mention noop explicitly in their prompts
Acceptance Criteria
- Documentation explicitly states noop is required (not optional) when no action is taken
- All example workflows in
.github/workflows/*.mdinclude explicit noop instruction in their prompts - Documentation includes a clear example showing when to call noop vs other safe-output tools
- Failure mode is documented: "what happens if you forget noop"
Generated by Plan Command for issue #discussion #18026
- expires on Feb 26, 2026, 3:15 AM UTC
Reactions are currently unavailable