Linear Issue Management

Before using Linear workflows, search for linear MCP tools. If not found, treat as not installed.

Workflow

1. Retrieve issue details before starting: mcp__linear-server__get_issue
2. Check for sub-issues: Use mcp__linear-server__list_issues with parentId filter
3. Update issue status when completing: mcp__linear-server__update_issue
4. Add completion comment (REQUIRED): mcp__linear-server__create_comment

Creating Issues

When creating issues with mcp__linear-server__create_issue, MUST add the claude code label.

Completion Comment (REQUIRED)

Every completed issue MUST have a comment summarizing work done. This is critical for:

• Team visibility
• Code review context
• Future reference

PR Association (REQUIRED)

When creating PRs for Linear issues, include magic keywords in PR body:

• Fixes LOBE-123
• Closes LOBE-123
• Resolves LOBE-123

Per-Issue Completion Rule

When working on multiple issues, update EACH issue IMMEDIATELY after completing it:

1. Complete implementation
2. Run bun run type-check
3. Run related tests
4. Create PR if needed
5. Update status to “In Review” (NOT “Done”)
6. Add completion comment
7. Move to next issue

Note: Status → “In Review” when PR created. “Done” only after PR merged.

❌ Wrong: Complete all → Update all statuses → Add all comments

✅ Correct: Complete A → Update A → Comment A → Complete B → …