/validate-issue
Review a Linear issue and prepare it for execution — resolve questions, build a task checklist
Step
Human
Claude Code Agent
External Systems
Fetch
Fetches issue, comments, and sub-issues in parallel
mcp__linear__get_issue, list_comments, list_issues Issue + comments + children
Linear
Resolve
Scans for unresolved questions, TBD/TODO placeholders, unanswered Q&A threads
Looks at description + all comments
If questions exist: proceed with assumptions, wait, or post follow-ups?
Conditional Gate Resolves answered threads with summary comments
Posts "Resolved — [summary]" on each answered question
mcp__linear__save_comment Resolution comments posted
Linear
Explore
Reads CLAUDE.md, explores relevant packages and files
Identifies validation commands, conventions, files to change
Agent(subagent_type: "Explore") Build
Maps sub-issues or checklist items to tasks, preserving blocking order
Each task: independently testable, small enough for easy review, sub-issue IDs cross-referenced
Builds execution checklist: TODO, TEST, Then per task
TODO = specific files + changes. TEST = exact command + expected output. Then = run tests, commit, update Linear.
Update
Rewrites issue description with execution-ready checklist
Preserves Problem Statement, Current State, Proposed Approach. Adds Work Items section.
mcp__linear__save_issue Issue updated with task checklist
Linear
Report
Reports: questions resolved, task count, assumptions, risks
Next: "Run /execute-issue <ID>"
Human
Agent
External
Decision gate