linear-sop

Linear SOP Skill

TEMPLATE: This skill uses {{PLACEHOLDER}} tokens. Replace with your project values before use.

Purpose

Guide consistent ticket management. Provides evidence templates for the mandatory dev/staging/UAT evidence policy.

When This Skill Applies

• Creating new issues in the ticket system
• Updating ticket status
• Attaching evidence to tickets
• Parsing acceptance criteria
• Working with UUIDs and issue IDs

Ticket System Operations

Reading Issues

# Get issue by identifier
get_issue({ id: "{{TICKET_PREFIX}}-459" })

# List issues with filters
list_issues({
  team: "{{PROJECT_TEAM_NAME}}",
  state: "In Progress",
  assignee: "me",
})

Creating Issues

create_issue({
  title: "feat(scope): description",
  team: "{{PROJECT_TEAM_NAME}}",
  description: "## Summary\n\n...",
  labels: ["feature", "sprint-1"],
  parentId: "parent-uuid",  // Optional - for sub-issues
})

Updating Issues

update_issue({
  id: "{{TICKET_PREFIX}}-459",
  state: "Done",
})

Adding Comments

create_comment({
  issueId: "{{TICKET_PREFIX}}-459",
  body: "**Dev Evidence**\n\n...",
})

Program Structure

For work that spans many issues, most trackers have objects above the issue. Use them; do not flatten a program into a flat list of tickets.

The Hierarchy

Initiative          the program (one per program)
  └── Project       a Unit of Work — one coherent outcome
       ├── Milestone    an AI-DLC phase: Inception, Construction, Operations
       └── Issue        a Story
            └── Sub-issue   a Mob Elaboration task (created during Inception, not before)

Prerequisite: labels must already exist

Program build-out assumes these label namespaces are pre-created in the workspace. Create them before building the program, not during:

• bolt:0 … bolt:N — which Bolt an issue belongs to
• agent:* — the lead role (must match an actual agent role defined for the project)