/feature-dev-linear
Guided feature planning with codebase exploration and architecture design
Phase
Human
Claude Code Agent
External Systems
Discovery
"I want to build [feature]"
Or provides a Linear issue ID
Fetches issue context, team, project, labels
Also fetches completed sibling issues to learn decomposition patterns
mcp__linear__get_issue, list_comments Issue + project docs read
Linear
Research
Launches 2-3 code-explorer agents in parallel
Existing patterns, domain structures, integration points
Agent(subagent_type: "code-explorer") Reads all identified files, builds deep understanding
5-10 key files per explorer, patterns and conventions cataloged
Architect
Launches code-architect agents with Phase 2 findings
Agent(subagent_type: "code-architect") Presents 2-3 genuinely distinct approaches
Each: name, philosophy, files affected, tradeoffs, estimated scope
Decision Gate Chooses architecture approach
Or requests a hybrid of approaches
Required Decompose
Determines decomposition axis, enumerates work units
UI: component families × variants. Backend: entities × operations. Data: stages × formats.
Creates parent issue, Build sub-issue, Test sub-issue (blocked by Build)
mcp__linear__save_issue Parent + Build + Test issues created
Linear
Review
Presents full plan: sub-issue table with titles, files, deps, complexity
Decision Gate Approves breakdown or requests modifications
Required Create
Creates all decomposition sub-issues under Build
Each is fully self-contained: context, task, files, validation, acceptance criteria. No references to parent.
mcp__linear__save_issue (per sub-issue) Sub-issues + blocking relations created
Linear
Posts summary comment with execution order
"Ready for /execute-issue <Build ID>"
mcp__linear__save_comment Summary comment on parent
Linear
Quality
Designs integration test plan: cross-component, e2e flows, regressions
Simple (1-2 areas) = single Test issue. Complex (3+) = Test sub-issues.
Populates Test issue and updates parent with integration test plan
mcp__linear__save_issue Test issue populated, parent updated
Linear
Human
Agent
External
Decision gate