work-on-linear-issue

ampcode's avatarfrom ampcode

Fetches a Linear issue and creates a comprehensive plan for implementation.

⭐18stars🔀1forks📁View on GitHub🕐Updated Jan 9, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill bridges the gap between project management and technical execution by automating the initial phases of software development. It fetches real-time issue data from Linear and leverages AI to perform deep codebase exploration, resulting in a comprehensive, structured implementation plan. By focusing on over-preparation and architectural impact analysis, it helps developers minimize errors and ensure all edge cases, security implications, and testing requirements are addressed before the coding process begins.

Use Cases

  • Developer Onboarding: Quickly orient a developer to a new task by fetching Linear ticket details and generating a roadmap of the relevant codebase areas and required changes.
  • Technical Planning & Risk Mitigation: Use the skill to analyze complex issues and identify potential impacts on system performance, security, and backward compatibility before starting implementation.
  • Workflow Automation: Streamline the transition from 'To Do' to 'In Progress' by automatically generating a TODO list and technical strategy that requires only a final human approval.
  • Codebase Impact Analysis: Automatically identify which existing patterns and files need to be modified or updated based on the specific requirements of a Linear issue.
namework-on-linear-issue
descriptionFetches a Linear issue and creates a comprehensive plan for implementation.

Work on Linear Issue

Fetches issue details from Linear and guides you through creating a comprehensive implementation plan.

When to Use

  • When starting work on a Linear issue
  • When you need to analyze and plan implementation for an issue
  • When onboarding to a new task from Linear

Prerequisites

  • LINEAR_API_KEY environment variable must be set (can also be in .env file)
  • curl and jq must be installed

Usage

builtin:///skills/scripts/work-on-linear-issue <issue-abbreviation>

Examples:

builtin:///skills/scripts/work-on-linear-issue MC-123
builtin:///skills/scripts/work-on-linear-issue https://linear.app/abc/issue/MC-123/issue-title

Workflow

"AI models are geniuses who start from scratch on every task." — Noam Brown

Onboard yourself to the current task: • Use ultrathink. • Explore the codebase. • Ask questions if needed.

Goal: Be fully prepared to start working on the task.

Take as long as you need to prepare. Over-preparation is better than under-preparation.

Planning Tasks

  1. Review the issue details fetched from Linear

  2. Examine relevant parts of the codebase

  3. Analyze existing patterns and potential issues

  4. Create a comprehensive plan considering:

    • Required code changes
    • Potential impacts on other parts of the system
    • Necessary tests to be written or updated
    • Documentation updates
    • Performance considerations
    • Security implications
    • Backwards compatibility (if applicable)
    • Reference links to featurebase or user request sources
  5. Think deeply about edge cases, potential challenges, and best practices

  6. ASK FOR EXPLICIT APPROVAL before starting on the TODO list

Remember: Your task is to create a plan, not to implement changes. Focus on providing a thorough, well-thought-out strategy, then ASK FOR APPROVAL BEFORE STARTING WORK.