STRUCTURED

Work on Linear Issue

Contributed by DoguD

Improved by Laravel Company · 2026-09-07


name: resolve-linear-issue
description: You will receive a Linear issue ID, typically in the format of LLL-XX, where Ls are letters and Xs are digits. Your primary goal is to resolve this issue on a new branch and open a pull request (PR) to the main branch.

To accomplish this task, follow these detailed steps:

  1. Obtain Issue Context (Step 1)

    • Use the Linear MCP (Merge Code Pull Requests) tool to retrieve the details of the issue.
    • The issue ID is provided at the beginning of this prompt: LLL-XX.
  2. Initialize Your Development Environment (Step 2)

    • Ensure you are on the latest version of the main branch by performing a git pull if necessary.
    • Create a new branch in the following format: claude/issue-LLL-XX-short-3-4-word-description-of-the-issue.
    • Checkout to this new branch immediately after creation. All subsequent changes and commits should occur on this new branch only.
  3. Research and Plan Solution (Step 3)

    • Thoroughly investigate the codebase with respect to the issue details.
    • Develop a clear implementation plan. If any clarifications are needed regarding the issue, please request them before proceeding.
    • Verify your understanding of the problem and the proposed solution at each planning step.
  4. Implement and Commit Changes (Step 4)

    • Begin implementing the changes based on your plan.
    • Use git commit best practices for each commit. Ensure the commit messages are descriptive and follow the conventional commit format.
    • Document any significant decisions or assumptions in the commit messages.
  5. Review and Debug (Step 5)

    • After completing the implementation, take a fresh look at your changes.
    • Identify and address any potential issues, bugs, or edge cases that might arise.
    • Ensure the code meets the project's quality and style standards.
  6. Create Pull Request (Step 6)

    • Once confident that the changes are free of issues, create a pull request (PR) to the main branch.
    • Provide a clear and concise PR title that accurately describes the change.
    • Draft a PR description that summarizes the issue resolution and the fix provided.
    • Include any relevant details, screenshots, or demonstration links in the PR description.

Please ensure all steps are followed meticulously to maintain a clean and organized development process.

Original prompt (before our improvements)

--- name: work-on-linear-issue description: You will receive a Linear issue id usually on the the form of LLL-XX... where Ls are letters and Xs are digits. Your job is to resolve it on a new branch and open a PR to the branch main. --- You should follow these steps: 1. Use the Linear MCP to get the context of the issue, the issue number is at $0. 2. Start on the latest version of main, do a pull if necesseray. Then create a new branch in the format of claude/<ISSUE ID>-<SHORT 3-4 WORD DESCRIPTION OF THE ISSUE> checkout to this new branch. All your changes/commits should happen on the new branch. 3. Do your research of the codebase with respect to the info of the issue and come up with an implementation plan. While planning if you have any confusions ask for clarifications. Enter to planning after every verification step. 4. Implement while commiting along the way, following git commit best practices. 5. After you think you are done with the issue, with a clear fresh new perspective, re-look at your changes to identify possible issues, bugs, or edge cases. If there is any address them. 6. After you are confident that you have implemented the changes without problems, bugs, etc. create a PR to the main branch.