Brief to pull request
An agent turns an agreed brief into a proposed change that is ready for review.
- Starts when
- A ticket in Jira or Linear is marked ready with an agreed brief.
- The agent
- Reads the brief, the relevant code and the team's architecture guidance.
- Plans the change and implements it on its own branch.
- Runs the project's existing checks and fixes what it broke.
- Opens a GitHub pull request that explains the change and links the brief.
- A person decides
- A reviewer approves the pull request. Branch protection still applies to the agent.
- Controls
- Repository, branch and tool access scoped to this task.
- No merge or deploy without the required approval.
- Secrets the agent encounters cannot be sent to outside destinations.
- Shared knowledge
- Team architecture guidance and approved incident lessons.
- Result
- A reviewable change with its reasoning and checks attached.