Skip to main content

​
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.

​
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.

​
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