name: build-triggering
description: |
Triggers new Buildkite builds. Use when user asks:
- "Trigger a build"
- "Run CI"
- "Start a build for X"
- "Rebuild this"
- "Deploy to staging"
- "Kick off the pipeline"
- /buildkite:trigger

Build Triggering

Trigger new Buildkite builds with appropriate safety checks.

Available MCP Tools

Input Parsing

Parse from $ARGUMENTS or user's message:

Approach

1. Identify the pipeline
2. Parse from input
3. Use buildkite_get_pipeline to verify

4. If unclear, ask the user

5. Determine parameters

6. Branch: From input, current git branch, or ask
7. Commit: Usually HEAD/latest
8. Message: Optional custom message

9. Environment: Any custom env vars

10. Confirm before triggering

11. Show exactly what will be triggered
12. Require explicit confirmation

13. Be extra careful with deploy/production pipelines

14. Create the build with buildkite_create_build

15. Report result

16. Provide build URL
17. Show initial status

Safety Requirements

Always Confirm

I'll trigger a build for **my-org/my-pipeline**:
- Branch: `main`
- Commit: `abc123` (latest)

Proceed? (yes/no)

Extra Caution for Sensitive Pipelines

If pipeline name contains: deploy, prod, production, release

⚠️ This appears to be a deployment pipeline.

I'll trigger **my-org/deploy-production**:
- Branch: `main`
- Commit: `abc123`

This may deploy to production. Please confirm by typing "deploy" to proceed.

Environment Variables

If setting env vars, show them clearly:

Build will include these environment variables:
- DEPLOY_ENV=staging
- SKIP_TESTS=true

Proceed?

Build Parameters

Response Format

After triggering:

✅ Build triggered successfully!

**Build #457**: https://buildkite.com/my-org/my-pipeline/builds/457
- Branch: main
- Commit: abc123
- Status: scheduled

The build is now queued and will start when an agent is available.

Example Interaction

User: Run CI on my branch

1. Identify pipeline (from context or ask)
2. Get current git branch
3. Confirm: "Trigger my-pipeline on feature-branch?"
4. On confirmation, create build
5. Return build URL and status