Objective
Add deployment_status event documentation and examples to the create-agentic-workflow prompt so the agent suggests it for external deployment monitoring scenarios instead of defaulting to workflow_run.
Context
From Agent Persona Exploration discussion #18250, the DO-1 (Failed Deployment Incident Creator) scenario scored 4.4/5.0. The agent applies the workflow_run + if:failure pattern correctly but misses deployment_status as a better trigger for external deployment services (e.g., Heroku, Vercel, Railway, Fly.io).
Approach
- Locate the
create-agentic-workflow prompt/skill
- Add a section on
deployment_status event:
- Explain when to use it: external deployment services that post deployment status back to GitHub
- Show the trigger syntax:
- Add
if: github.event.deployment_status.state == 'failure' condition example
- Distinguish from
workflow_run: use deployment_status for external deployments, workflow_run for GitHub Actions-internal pipelines
- Consider adding a reference workflow for deployment incident creation
Files to Modify
- Update: the
create-agentic-workflow prompt/skill with deployment_status guidance
- Optionally create:
.github/workflows/deployment-incident.md reference workflow
Acceptance Criteria
Generated by Plan Command for issue #discussion #18250
Objective
Add
deployment_statusevent documentation and examples to thecreate-agentic-workflowprompt so the agent suggests it for external deployment monitoring scenarios instead of defaulting toworkflow_run.Context
From Agent Persona Exploration discussion #18250, the DO-1 (Failed Deployment Incident Creator) scenario scored 4.4/5.0. The agent applies the
workflow_run + if:failurepattern correctly but missesdeployment_statusas a better trigger for external deployment services (e.g., Heroku, Vercel, Railway, Fly.io).Approach
create-agentic-workflowprompt/skilldeployment_statusevent:if: github.event.deployment_status.state == 'failure'condition exampleworkflow_run: usedeployment_statusfor external deployments,workflow_runfor GitHub Actions-internal pipelinesFiles to Modify
create-agentic-workflowprompt/skill withdeployment_statusguidance.github/workflows/deployment-incident.mdreference workflowAcceptance Criteria
deployment_statustrigger is documented in the create promptdeployment_statuswhen user describes external deployment monitoringdeployment_statusvsworkflow_run