← ClaudeAtlas

dispatching-research-tasklisted

Dispatch a Shipyard research task subagent.
Acendas/shipyard · ★ 2 · AI & Automation · score 70
Install: claude install-skill Acendas/shipyard
# Dispatching a Research Task **Render before asking.** Before any AskUserQuestion, render the decision context as assistant chat text. Content that exists only in a Read result, a subagent/Agent return, or the question/option strings **does not count as rendered** (the UI shows a compact card) — restate it in chat first. A `kind: research` task answers a question. Its deliverable is a markdown findings doc, not code. The subagent reads (codebase, web, docs), reasons, and writes a single output file. Wrong dispatch → silent-pass bug: feature builders have no Red step for a research-shaped task and exit clean on an empty tree, satisfying the "Before Exiting" gate trivially. Route here. ## When to Invoke `/ship-execute` calls this skill when a task's frontmatter has `kind: research`. Other entry points: - `/ship-discuss` may invoke this for an inline technical investigation during feature shaping ("which JWT library should we use?"). - `/ship-sprint` may invoke this during planning when a feature can't be specced without a design tradeoff analysis. Per the action items, the routing decision (`kind: feature` vs `operational` vs `research`) lives in the calling command skill. This skill assumes the routing already chose research. ## Inputs - `task_id` — e.g., `R-013` (research tasks conventionally use `R-` prefix, but any ID works). - `task_file_path` — absolute path under `<SHIPYARD_DATA>/spec/tasks/`. - `parent_feature_path` — absolute path or null. - `data_dir` — liter