https://github.com/jeffhandley/gh-aw-field-guide
A field guide to using GitHub Workflows and Agentic Workflows
https://github.com/jeffhandley/gh-aw-field-guide
agentic-workflow github workflows
Last synced: 29 days ago
JSON representation
A field guide to using GitHub Workflows and Agentic Workflows
- Host: GitHub
- URL: https://github.com/jeffhandley/gh-aw-field-guide
- Owner: jeffhandley
- License: apache-2.0
- Created: 2026-04-18T07:45:29.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-18T13:06:30.000Z (2 months ago)
- Last Synced: 2026-04-18T14:37:25.598Z (2 months ago)
- Topics: agentic-workflow, github, workflows
- Homepage: https://jeffhandley.com/gh-aw-field-guide/
- Size: 154 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GitHub Agentic Workflows — Field Guide
## Tenets
The design principles every workflow must consider and strive to satisfy. These tenets inform the usage guidelines and recommendations throughout this guide.
[Read the Tenets →](chapters/tenets.md)
## Triggers
A reference for triggers used in [traditional GitHub Workflows](https://docs.github.com/actions/writing-workflows) and in [GitHub Agentic Workflows (`gh-aw`)](https://gh.io/gh-aw), covering how security and other tenets apply to each trigger. Scenarios, high-level guidance, and notable pitfalls.
[Study the Common Triggers →](chapters/triggers.md)
---
## More Thoughts
1. [The "Approve and run workflows" Gate](chapters/approve-and-run-gate.md) — the gate is dangerous, not protective.
1. [The "Apparent vs. Actual" Trigger Surface](chapters/apparent-vs-actual.md) — why "skipped" runs are not free.
1. [Operating Within a Fork](chapters/operating-in-a-fork.md) — what fires when you operate inside your own fork, and the `if: workflow_dispatch || not-a-fork` guard.
1. [Concurrency and Race Conditions](chapters/concurrency-and-races.md) — the non-matching-cancels-matching pathology, the pre-cancellation race.
1. [Authorization, Roles, and Read-Only Contributors](chapters/authorization-and-roles.md) — `on.roles:` defaults, the read-only / fork-contributor capability matrix.
## Appendices
- [Trigger-by-Trigger Risk Profile](appendices/trigger-risk-profile.md) — the all-triggers reference table including ones with no standalone page.