Part
Trigger
You might say: event, start condition, hook
The event that starts a run. It carries enough identity and context for the orchestrator to choose a task.
- What it does
- Converts a change in a tracker, git host, clock, monitor, or prior run into one dispatch decision.
- Ask
- Which event starts this task, which activity types count, and what stops the event from starting a duplicate run?
- Typical
- Ticket created or labelled, status moved, comment or mention, pull request opened, check failed, review submitted, schedule, run finished, monitor alert, or manual dispatch.
- Trouble
- A broad event fires too often, a self-written event loops, or a filtered event leaves work silently unhandled.
What to look for
- An event name and activity type in a run record
- A webhook delivery or schedule rule
- A manual Run workflow control
Catalogue: Trigger kind
- Ticket created: A new ticket enters the tracker and starts intake or triage.
- Ticket labelled: A label is added to a ticket and selects a task such as implementation.
- Status moved: A ticket moves from one workflow state to another, such as Ready to In progress.
- Comment or mention: A new comment or an explicit mention asks a task to respond.
- Pull request opened: A new pull request starts checks or an automated review.
- Check failed: A check or commit status reports failure and starts diagnosis or rework.
- Review submitted: A reviewer submits an approval, request for changes, or comment on a pull request.
- Schedule: A clock starts a task at a configured time or interval.
- Run finished: A completed or requested run starts the next task in a chain.
- Monitor alert: A monitored signal crosses a threshold and asks the factory to investigate.
- Manual dispatch: A person presses a run control or sends a dispatch API call.
Connections
Sources
- GitHub, Events that trigger workflows, About events that trigger workflows
You can configure your workflows to run when specific activity on GitHub happens, at a scheduled time, or when an event outside of GitHub occurs.
- GitHub, Triggering a workflow, Using events to trigger workflows
If multiple triggering events for your workflow occur at the same time, multiple workflow runs will be triggered.
- GitLab, Trigger pipelines with the API, Trigger a pipeline
You can use an API call to the pipeline triggers API endpoint to trigger a pipeline for a specific branch or tag.
Use it on your project
teardown-apply: hold "Trigger" (trigger) from the teardown at https://teardownatlas.com/software-factory/ against my project
Paste it into a coding agent that has the teardown skills.
An AI agent wrote this map with the teardown skill. It can contain errors: check the sources before you rely on a part. About and legal