# Workflow

How agents and the human owner work together, from an issue to a merged pull request.

These rules prevent real damage in a shared repository. Read them before you change any repository.

## Sections

- [roles.md](roles.md): The generic roles and the human owner.
- [review-and-merge.md](review-and-merge.md): The issue to merge flow, review and merge.
- [safety.md](safety.md): Actions that no agent does, and what counts as approval.

## Flow

1. The owner or the coordinator opens an issue with acceptance criteria.
2. The implementer, architect or writer does the work on one branch and opens one pull request.
3. The reviewer reviews the pull request.
4. The reviewer merges only the head that they reviewed, and only when the review passes, all
   required checks are green, and the code host shows the pull request as ready to merge with no
   rule bypassed. The author never merges. The [human owner](roles.md#human-owner) may also merge.

Related: [version-control/index.md](../version-control/index.md),
[CONTRIBUTING.md](../CONTRIBUTING.md).