Skip to content

feat(skills): add linear-deep-dive skill#1195

Merged
kentwelcome merged 2 commits intomainfrom
feature/linear-deep-dive-skill
Mar 10, 2026
Merged

feat(skills): add linear-deep-dive skill#1195
kentwelcome merged 2 commits intomainfrom
feature/linear-deep-dive-skill

Conversation

@gcko
Copy link
Contributor

@gcko gcko commented Mar 10, 2026

Summary

  • Adds a new Claude Code skill (/linear-deep-dive) that fetches a Linear issue, classifies it (feature/bug/refactor/investigation), explores the relevant codebase, proposes an approach, and orchestrates the right skill chain to solve it
  • Integrates with Linear MCP server, superpowers skills (brainstorming, writing-plans, systematic-debugging, TDD, executing-plans), and Explore agents
  • Includes edge case handling for blocked issues, vague specs, full-stack work, and WIP branches

Test plan

  • Skill loads correctly via /linear-deep-dive DRC-2893 (verified in session)
  • Test with a Feature-labeled issue to verify brainstorming → writing-plans routing
  • Test with a Bug-labeled issue to verify systematic-debugging → TDD routing
  • Test with an issue that has blockedBy relations

Checklist

  • Signed-off-by (DCO)
  • No state files committed
  • No changes to recce/data/

🤖 Generated with Claude Code

…stration

Adds a new Claude Code skill that fetches a Linear issue, classifies it
(feature/bug/refactor/investigation), explores the relevant codebase,
proposes an approach, and orchestrates the right skill chain to solve it.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: Jared Scott <jared.scott@datarecce.io>
@gcko gcko requested a review from Copilot March 10, 2026 03:25
@gcko gcko self-assigned this Mar 10, 2026
@gcko gcko requested a review from kentwelcome March 10, 2026 03:25
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new Claude skill (/linear-deep-dive) to drive end-to-end analysis of a Linear issue: fetch issue context, classify work type, explore relevant code, produce an approach proposal, and then orchestrate an appropriate skill chain.

Changes:

  • Introduces the linear-deep-dive skill definition and workflow documentation.
  • Defines default routing from Linear issue classification (feature/bug/refactor/investigation) to skill chains.
  • Documents branch handling and several edge-case decision points (blockers, vague specs, full-stack scope, WIP branches).

@gcko
Copy link
Contributor Author

gcko commented Mar 10, 2026

Code Review — PR #1195

Summary

Adds a new Claude Code skill (/linear-deep-dive) for analyzing Linear issues and orchestrating the appropriate workflow. This is a markdown-only skill definition — no executable code. The skill is well-structured, follows established conventions from the existing skills (claude-code-review, recce-mcp-e2e), and correctly references existing superpowers skills.

Findings

No critical issues found.

Observations (not blocking):

  • The skill correctly uses the mcp__claude_ai_Linear__get_issue and mcp__claude_ai_Linear__list_comments tools for fetching issue data
  • The classification table (feature/bug/refactor/investigation) with mapped skill chains is well-designed
  • Edge cases (blockers, vague issues, WIP branches, full-stack issues) are handled
  • The iron rules section enforces the right guardrails (always fetch first, always confirm with user, stay in scope)
  • The process flow diagram follows the same digraph convention used in claude-code-review

Verdict

Approved. Clean addition of a single skill file with no impact on existing code.

- Use `git checkout -t origin/$BRANCH` for robust remote branch tracking
- Use `origin/` refs in git log for branch inspection
- Change investigation output from docs/summaries/ to docs/plans/ (already created)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Signed-off-by: Jared Scott <jared.scott@datarecce.io>
Copy link
Member

@kentwelcome kentwelcome left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@kentwelcome kentwelcome merged commit 0ee292c into main Mar 10, 2026
12 checks passed
@kentwelcome kentwelcome deleted the feature/linear-deep-dive-skill branch March 10, 2026 03:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants