# Hand a well-scoped issue to GitHub Copilot's cloud agent and review its PR

> Write the issue like a ticket for a junior engineer, assign it to Copilot, steer it with @copilot comments on the PR, and review it like any other contribution.

- **Category:** [Coding](https://stepgleam.com/categories/coding)
- **Difficulty:** Beginner
- **Time:** ~25 minutes
- **Tools:** GitHub Copilot cloud agent, GitHub
- **Reliability score:** 78/100
- **Steps:** 5
- **Last updated:** 2026-10-26
- **Published:** 2026-10-26

## Tools used

- [GitHub Copilot cloud agent](https://docs.github.com/en/copilot) — Works the issue in the background and opens a PR
- [GitHub](https://github.com) — Issues, PRs and Actions

## What you'll get

A merged Copilot PR that you reviewed and iterated on, with a second approver if your repo requires one.

## Who this is for

Teams and solo developers with a backlog of small, clear issues.

## Before you start

Developers on r/GithubCopilot and r/github who assign issues to Copilot describe the same arc: vague issues fail, detailed ones work, and you iterate through PR comments. GitHub's docs add the review rules.

## Steps

### Step 1: Pick an issue you would give a junior-to-mid engineer

One heavy user's test: *"Is this an issue that I would assign to a junior-mid level software engineer?"* They break large projects into smaller tickets and assign them one at a time. Triage, they found, doesn't work well.

[Open step 1](https://stepgleam.com/guides/hand-a-well-scoped-issue-to-github-copilots-cloud-agent#step-1)

### Step 2: Write the issue in more detail than feels necessary

**Tool:** GitHub

*"It took a few attempts to understand that issues have to be overly descriptive and detailed. Once the issue had better instructions, copilot managed to successfully complete a legit pending issue from our backlog."* Another user says it works on *"any issue that has good custom instructions or agent md file steering the agent."*

[Open step 2](https://stepgleam.com/guides/hand-a-well-scoped-issue-to-github-copilots-cloud-agent#step-2)

### Step 3: Assign the issue to Copilot

**Tool:** GitHub Copilot cloud agent

Assign the issue to **Copilot**. It creates a branch and a PR, works in GitHub Actions, and asks for your review when done. One user notes it always branches from the default branch, even if you name another.

[Open step 3](https://stepgleam.com/guides/hand-a-well-scoped-issue-to-github-copilots-cloud-agent#step-3)

### Step 4: Steer it with @copilot comments on the PR

**Tool:** GitHub

To request changes, mention **@copilot** in a PR comment or push commits to the branch. A user: *"you can keep adding comments to the pull request and copilot will continue working based on your comments."*

**Prompt:**

```
@copilot the date filter should include the end date; add a test for that case.
```

[Open step 4](https://stepgleam.com/guides/hand-a-well-scoped-issue-to-github-copilots-cloud-agent#step-4)

### Step 5: Review it like any contribution and check workflow changes

**Tool:** GitHub

GitHub's docs say Copilot PRs *"deserve the same thorough review as any contribution."* Actions don't run automatically on Copilot's pushes, so read the diff first, especially anything in `.github/workflows/`. If approvals are required, your approval doesn't count toward them; another reviewer must approve.

**Why this works:** Workflows can access secrets.

[Open step 5](https://stepgleam.com/guides/hand-a-well-scoped-issue-to-github-copilots-cloud-agent#step-5)

## Pro tips

- Add repository instructions such as AGENTS.md so every task starts with your conventions.
- Keep tickets small: one concern per issue.

## Common mistakes

- Assigning a one-line issue and expecting the right result.
- Approving workflow runs without reading changes to .github/workflows.

## FAQ

### Does it run tests?

Users report it iterates in GitHub Actions and usually finishes with passing tests, though not always.

### Which plans have it?

GitHub lists the cloud agent for all paid Copilot plans.

---

Canonical guide: https://stepgleam.com/guides/hand-a-well-scoped-issue-to-github-copilots-cloud-agent
Read this guide as Markdown: https://stepgleam.com/guides/hand-a-well-scoped-issue-to-github-copilots-cloud-agent.md