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: "ASP-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: "ASP-459",
  state: "Done",
})

Adding Comments

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

Evidence Policy (MUST)

Every issue requires evidence at each phase:

Phase	Required?	Content
Dev	MUST	Implementation proof
Staging	MUST	UAT validation (or N/A)
Done	MUST	Final verification

Evidence Templates

Dev Evidence Template

**Dev Evidence**

**PR**: https://github.com/{{ORG_NAME}}/{{REPO_NAME}}/pull/XXX
**Commit**: [short-hash]
**Branch**: ASP-XXX-description

**Implementation:**
- [x] Feature implemented
- [x] Tests passing
- [x] Lint passing

**Verification:**
{{CI_VALIDATE_COMMAND}}
# Output: All checks passed

Staging/UAT Evidence Template

**Staging Evidence**

**Environment**: {{STAGING_ENV_NAME}}
**URL**: {{STAGING_URL}}

**Validation Steps:**
1. Deployed to staging: [timestamp]
2. Smoke test passed: [yes/no]
3. Feature verified: [description]

**UAT Status:** [Passed/Pending/N/A]

If N/A, reason: [e.g., "Dev tooling only - no user-facing changes"]