> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blocks.team/llms.txt
> Use this file to discover all available pages before exploring further.

# Ticket Assignment

## Overview

Assign a Linear or GitHub issue to Blocks and it will implement the changes and open a pull request with a summary of what was done and how to test it. Blocks posts status updates directly to the ticket as it works — you can also monitor progress from the [dashboard](/using-blocks/dashboard).

## Assigning a Ticket

### Linear and GitHub Issues

The flow is the same for both integrations. There are two ways to assign a ticket:

**Native assignment** — Assign the ticket to Blocks using the assignee field. Blocks will start working on it automatically.

**Comment mention** — Mention Blocks in a comment with specific instructions, for example:

* `@blocks implement this ticket`
* `@blocks fix this without changing the public API`
* `@blocks implement this using the existing authentication pattern`

**Tip**: You can set the default behavior for native assignments in **Settings > Integrations > Linear** (or GitHub). Set the default assign mode to "plan" to have Blocks propose an implementation plan before writing any code.

## Plan Mode for Complex Tickets

For larger features or architectural changes, use `/plan` to review the approach before implementation begins:

`@blocks /plan implement user authentication with OAuth`

Blocks will outline its plan as a ticket comment for you to review and refine. Learn more about [Plan Mode](/using-blocks/features/plan-mode).

## Best Practices

* **Write clear acceptance criteria** — the more specific the ticket, the better the output
* **Link related resources** — reference related issues, PRs, or documentation in the ticket
* **Use plan mode for complex work** — collaborate on the approach before code is written

## Related

* [Linear Integration](/using-blocks/integrations/linear) - Set up Blocks with Linear
* [GitHub Integration](/using-blocks/integrations/github) - Set up Blocks with GitHub
* [Plan Mode](/using-blocks/features/plan-mode) - Collaborative planning before implementation