Thanks for improving Agent Workflows.
This repo is about reusable runbooks for coding agents. Keep contributions small, clear, and easy to adapt.
Add new canonical workflows to runbooks/.
A workflow should read like a step-by-step guide. It should tell the agent what to do first, what decision to make next, when to stop, and what evidence to report.
Good workflows are specific enough to change agent behavior, but not so specific that they only work in one codebase.
Put agent-specific guidance in docs/installation.md or a focused adapter doc.
Use primary docs when possible. If behavior is based on local testing rather than docs, say so.
Before opening a PR:
- check for clear wording
- check that the workflow has evidence and stop conditions
- avoid broad platform claims without sources
- avoid duplicating capability guidance that belongs in skills