codyswanngt/research

Research

Produce a PRD for the problem in $ARGUMENTS, then create it in the configured PRD source.

Inputs

• The problem statement / feature idea (required) — free text, a feasibility card, or a URL.
• prd_ready (optional, default false) — false creates the PRD in the source's draft role for human review; true creates it in the ready role so lisa:intake (PRD side) auto-claims it.
• dedupe_key / marker (optional) — a stable dedupe marker (e.g. supplied by lisa:project-ideation) embedded in the created PRD so re-runs reference the existing PRD rather than creating a duplicate.
• ideation_ledger_payload (optional, required when invoked by lisa:project-ideation) — a structured metadata object to forward unchanged to lisa:prd-source-write. It carries the selected marker, automation id/path when available, persona names, persona evidence references, rejected overlap candidates, repo identity, prd_ready, selected idea title/key, and expected empirical verification artifact. research may use these fields to inform the PRD body, but must not discard, rename, or vendor-render them.

Orchestration: agent team

If you are NOT already operating inside an agent team (no prior successful team-creation or subagent-delegation tool call in this session, not spawned into a team context), the very first thing you do is establish team orchestration.

Use the team tool for the current runtime:

• Claude: use TeamCreate. If TeamCreate has not been loaded yet, first use ToolSearch with query: "select:TeamCreate" to load its schema.
• Codex: do not call TeamCreate; Codex does not expose that Claude tool. Use tool_search with a query like multi-agent tools to load multi_agent_v1, then use multi_agent_v1.spawn_agent for teammate delegation. Treat the first successful spawn_agent call as establishing team orchestration.
• Other runtimes: use the current runtime's tool-discovery mechanism to discover and call the appropriate multi-agent/team tool.

If no team creation or subagent delegation tool is available, explicitly state that team orchestration is unavailable in this runtime, continue as the lead agent, and preserve the workflow's review, verification, and task-tracking obligations locally.

Until the team is established, the first Codex teammate has been spawned, or the no-team fallback has been declared, do NOT call any of: Agent, TaskCreate, Skill, MCP tools (Atlassian / Linear / GitHub / Notion), Read, Write, Edit, Bash, Grep, Glob. Gathering context inline as the lead is the exact bypass path that produces ad-hoc work instead of a real team flow.

If you ARE already inside an agent team (e.g., a teammate invoked this skill via the Skill tool), do NOT create a second team — many harnesses reject double-creates — and do NOT collapse the nested flow into a single inline worker. A nested team-first flow must still bring in the specialists it requires by adding them to the existing team, not by doing the work itself:

• Claude: teams are flat and only the lead can add named teammates, so do NOT call Agent with a name from a teammate (the harness rejects it: "Teammates cannot spawn other teammates — the team roster is flat"). Send the team lead a message naming the specialist teammate(s) this flow needs, their task assignments, and completion criteria, then coordinate through the shared task list until they finish. An anonymous subagent (Agent with name omitted) is permitted only for bounded one-shot work whose result returns directly to you — it is not a substitute for the required lifecycle specialists.
• Codex: do NOT call TeamCreate. If the lead/root agent is addressable (you were given its id/handle), send it a request to multi_agent_v1.spawn_agent the specialist agent(s), including each agent's prompt, ownership, and expected result. If no lead handle exists but spawn_agent is available to you, spawn only the bounded specialist agent(s) this flow needs, wait_agent for their results, and relay those results upward to the parent/lead.

Treat the first successful lead-spawn request (or, on the Codex fallback, the first specialist spawn) as preserving team orchestration. Never satisfy a team-first lifecycle flow by doing all the work inline.

Flow

Execute the Research flow as defined in the intent-routing rule (loaded via the lisa plugin). The rule contains the canonical step sequence (gates, sub-flows, deliverables). This skill does NOT restate flow steps — change them in the rule, propagate everywhere.

Output

A PRD created in the configured PRD source (per the intent-routing rule's Research flow definition) containing: context, problem statement, user flows, acceptance criteria, technical feasibility notes, open questions, and the "Recommended Tooling for Plan Phase" section. The final flow step invokes lisa:prd-source-write, which creates the PRD in the configured source (Notion page in the PRD database, Confluence page under the lifecycle parent, GitHub issue, or Linear project) in the draft role by default or ready when prd_ready=true. The PRD lives in the source — there is no loose document artifact. Before handing the synthesized PRD to lisa:prd-source-write, record the Research run's direct usage on that artifact through lisa:usage-accounting so the PRD body carries the canonical ## Lisa Usage ledger from creation time onward. If the runtime does not expose trustworthy usage, the direct entry must still be written with source: unavailable and nullable token/cost fields rather than silently omitting the Research row. If the call includes ideation_ledger_payload, pass that object through in the lisa:prd-source-write spec unchanged alongside marker, dedupe_key, and initial_role; this is the vendor-neutral handoff that lets the configured writer render an auditable run ledger without research bypassing source selection. A source must be configured; if it is not, stop and report it rather than emitting a document. The Plan flow consumes the created PRD next.