ticket-manager

Linear - Ticket Management (Local Mode)

You are tasked with managing "Linear tickets" locally using markdown files stored in the user's global configuration directory and the WriteTodosTool. This replaces the cloud-based Linear MCP workflow.

Core Concepts

1. Tickets as Files: Tickets are stored as markdown files in the active session directory.

   • Locate Session: The session root is injected as ${SESSION_ROOT} in your context.
   • Parent Ticket: Stored in the session root: ${SESSION_ROOT}/linear_ticket_parent.md.
   • Child Tickets: Stored in dedicated subdirectories: ${SESSION_ROOT}/[child_hash]/linear_ticket_[child_hash].md.
   • Format: Frontmatter for metadata, Markdown body for content.

2. Session Planning: Use WriteTodosTool to track immediate subtasks when working on a specific ticket in the current session.

Initial Setup & Interaction

You do not need to run a script to find the session. It is provided in your context as ${SESSION_ROOT}.

Action-Specific Instructions

1. Creating Tickets from Thoughts

1. Draft the ticket summary: Present a draft to the user.

2. Create the Linear ticket:

   • Generate ID: openssl rand -hex 4 (or internal random string).
   • Create Directory: mkdir -p ${SESSION_ROOT}/[ID]
   • Write file to ${SESSION_ROOT}/[ID]/linear_ticket_[ID].md with Frontmatter and Markdown content.
   • Important: Set both created and updated to today's date.

5. PRD Breakdown & Hierarchy

When tasked with breaking down a PRD or large task:

1. Identify Session Root: Use the ${SESSION_ROOT} provided in your context.

2. Create Parent Ticket:

   • Create the "Parent" ticket in the session root: ${SESSION_ROOT}/linear_ticket_parent.md.
   • Status: "Backlog" or "Research Needed".
   • Title: "[Epic] [Feature Name]".
   • Links: Add link to PRD.

3. Create Child Tickets (ATOMIC IMPLEMENTATION):

   • Break the PRD into atomic implementation tasks (e.g., "Implement Backend API", "Develop Frontend UI", "Integrate Services").
   • CRITICAL (NO JERRY-WORK): Every ticket MUST be an implementation task that results in a functional change or a testable unit of work.
   • STRICTLY FORBIDDEN: Do NOT create "Research only", "Investigation only", or "Documentation only" tickets. Research and Planning are MANDATORY internal phases of EVERY implementation ticket.
   • Execution Order: Respect the "Implementation Plan" and "Phases & Ticket Order" defined in the PRD.
   • Order Field: Assign a numerical order field to each ticket (e.g., 10, 20, 30).
   • For each child:
     • Generate Hash: [child_hash]
     • Create Directory: ${SESSION_ROOT}/[child_hash]/
     • Create Ticket: ${SESSION_ROOT}/[child_hash]/linear_ticket_[child_hash].md
     • Linkage: In the links section of each child ticket, add:

       links:
         - url: ../linear_ticket_parent.md
           title: Parent Ticket
       

     • TEMPLATE: You MUST use the Ticket Template below for all tickets.