Workflow patterns
Practical patterns for building real-world KiCI workflows in TypeScript. The patterns are organised across five pages — start with Basic CI if you’re new, or jump to Integrations if you’re wiring up a non-GitHub forge or a generic webhook.
| Page | Covers |
|---|---|
| Basic CI | Single-job CI, PR-only / push-only filters, multiple triggers on one workflow, manual-only workflows. |
| Conditionals & matrix | Conditional execution with rules, matrix builds (static + dynamic), and dynamic job generation. |
| Integrations | Workflow chaining, generic webhooks, Stripe handlers, self-hosted git forges (Forgejo / Gitea / Gogs), plain GitHub repo webhooks (no GitHub App). |
| Scheduling & events | Nightly cron, workflow-complete-triggered deploys, custom event chaining. |
| Pattern reference | Step context, the examples repository, and GitHub check run output — cross-cutting reference shared by every pattern above. |
See also
Section titled “See also”- Event system — event model concepts, registration model, circuit breaker
- SDK reference — complete API reference for all functions used in these patterns
- CLI reference — how to compile and test these workflows locally
- Getting started — installation and first workflow setup
- Job execution lifecycle — how agents execute the jobs defined in these patterns
- GitHub checks architecture — deep dive into the check run system