Menu
MUST USE when the user asks for deepwork-style planning, multi-agent execution, code review, research, or workflow routing inside Codex.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use after all implementation tasks complete, after major features are integrated, or before merging to verify work meets requirements
Use when executing implementation plans with independent tasks in the current session
Use after all implementation tasks complete, after major features are integrated, or before merging to verify work meets requirements
Use when executing implementation plans with independent tasks in the current session
Use before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
Use when you have a spec or requirements for a multi-step task, before touching code
| name | deepwork |
| description | MUST USE when the user asks for deepwork-style planning, multi-agent execution, code review, research, or workflow routing inside Codex. |
This is the Codex adapter skill for deepwork. Use it to apply Deepwork's autonomous workflow semantics inside Codex while leaving the OpenCode plugin untouched.
update_plan for TodoWrite-style planning.apply_patch for manual edits; use shell commands for read-only inspection and project verification.dw-* agent TOML files from this plugin bundle's agents/ directory as installable profiles when you want Deepwork role prompts as Codex agents. Resolve the directory relative to the installed plugin root, not a source checkout path.Configured workflow: codex
dw-* Codex agent.When a Deepwork role maps to a generated agent, use the exact Codex agent type when the current dispatch tool can select it. A generic or flat subagent does not load the generated profile; when that is the only callable route, follow the generic fallback below and state the role, skills, and task explicitly in its message.
[@dw-plan-critic](subagent://dw-plan-critic) or multi_agent_v1.spawn_agent(agent_type="dw-plan-critic", fork_context=false, message="Review the plan at <path>.")[@dw-reviewer](subagent://dw-reviewer) or multi_agent_v1.spawn_agent(agent_type="dw-reviewer", fork_context=false, message="<bounded review task>")[@dw-oracle](subagent://dw-oracle) first, then [@dw-oracle-2nd](subagent://dw-oracle-2nd) through configured later slots only when additional independent evidence is explicitly needed.When Codex exposes MultiAgentV2 flat tools, map Deepwork delegation to the available flat tool names instead of forcing V1 syntax: use spawn_agent to create a bounded agent, wait_agent to wait for completion, followup_task to continue an existing agent, interrupt_agent to stop a runaway agent, and fork_turns only for explicit branch-style exploration. If those names are not callable in the current thread, fall back to the route order below.
The dw-* agent profile is the preferred selector. When a current native dispatch tool can select that profile directly, use it before any generic route.
Do not pass dw-*.toml files as items, skill attachments, or prompt context to a generic subagent. TOML files are installation artifacts for Codex's agent registry, not runtime skills.
The current callable dispatch-tool schema is the only availability signal. MultiAgent V1/V2 names are useful hints but not a contract: use any current or future native dispatch surface only according to the parameters it actually exposes. Do not inspect unrelated or deferred tools for a hidden profile selector. An [@dw-*](subagent://dw-*) link does not spawn an agent, and a task_name does not select a profile.
Use the first available native route in this order:
Exact profile — a tool field such as agent_type, agent_path, or agent_nickname only when the current tool schema or its documentation explicitly guarantees that it selects the generated dw-* profile.
Direct composition — a native dispatch tool that can choose the required model and supply the role's actual system or developer instructions plus skills. Select the matching model from the role tier below, supply the selected role's generated developer-instruction content (not its TOML wrapper), and attach or load the workflow skill and task-relevant SKILL.md artifacts through the fields the tool actually exposes. State that this is a generic fallback, not an exact-profile invocation.
Generic or flat dispatch — when a callable subagent tool can only accept a task identity and message (for example task_name, message, and fork_turns), still delegate. Put this self-contained envelope in message:
TASK: <imperative, bounded assignment>
ROLE:
DELIVERABLE:
SCOPE: <files, context, and boundaries>
VERIFY: <test, evidence, or observable result>
REQUIRED SKILLS:
CONTEXT:
CONSTRAINTS:
Use any real skill-loading field only when it is exposed. Do not claim that this loaded the dw-* profile; the child uses its inherited/default model and follows the role and skill guidance in the message.
Local execution — use only when no callable native subagent-dispatch route is available.
If an exact dw-* invocation returns unknown agent_type, continue at route 2 when it is complete enough, otherwise use route 3. A tool limited to task_name, message, and fork_turns cannot select a model or load the profile payload, but it is still a valid generic/flat dispatch route. Install the generated TOML files into project .codex/agents/ or personal ~/.codex/agents/ and restart or refresh the Codex thread only when restoring exact-profile delegation is itself in scope.
| Codex agent | Profile effort | Deepwork source |
|---|---|---|
| dw-builder | high | builder |
| dw-clarifier | high | clarifier |
| dw-code-search | high | code-search |
| dw-coding | high | coding |
| dw-complex | high | complex |
| dw-creative | high | creative |
| dw-deep | xhigh | deep |
| dw-doc-search | high | doc-search |
| dw-documenting | high | documenting |
| dw-explore | high | explore |
| dw-frontend | high | frontend |
| dw-hard-reasoning | xhigh | hard-reasoning |
| dw-media-reader | high | media-reader |
| dw-normal-task | high | normal-task |
| dw-oracle | xhigh | oracle |
| dw-oracle-2nd | xhigh | oracle-2nd |
| dw-orchestrator | high | orchestrator |
| dw-plan-critic | xhigh | plan-critic |
| dw-planner | xhigh | planner |
| dw-quick | high | quick |
| dw-research | high | research |
| dw-reviewer | xhigh | reviewer |
Generated profile defaults are installation metadata, not mandatory choices. Actual delegation must preserve explicit user configuration and select overrides only from the currently available model catalog.
For an exact profile, omit model and reasoning_effort by default so Codex can apply the selected dw-* profile. For direct composition, select the tier model below only when the current tool exposes model, preserve the profile's existing reasoning effort as the baseline, and load the selected role's developer instructions and required skills. For generic/flat dispatch with no model field, do not invent an override: the child inherits its native/default model while the role and skills are carried in message. An explicit user-selected model always wins.
Apply this section only when the current dispatch surface exposes a model field or an exact profile route that also accepts a model override. An explicit user-selected model always wins. Determine availability from the current callable surface or active model catalog; model names in examples are references only and never prove availability. When no suitable model in a lane is available, omit the override and preserve the generated profile's existing model and reasoning behavior unchanged.
| Role lane | Selection principle | Reasoning effort | Roles |
|---|---|---|---|
| Flagship | Best available primary reasoning model in the user's catalog | xhigh minimum for planning, deep implementation, hard reasoning, architecture, algorithmic, security, or high-risk work; use native max on GPT-5.6 when maximum reasoning is requested, and use the family-supported maximum elsewhere. high remains acceptable for coordination, implementation, or clarification roles below that threshold. | dw-orchestrator, dw-planner, dw-builder, dw-clarifier, dw-deep, dw-hard-reasoning |
| External review | Same primary reasoning lane as flagship work, selected from available models; Reviewer has logical tiers only and no ordinal slots | xhigh minimum; use native max on GPT-5.6 for complex, cross-module, security, performance, high-risk, or final-gate review | dw-reviewer |
| Ordered Oracle review | Oracle slots are model priority, not capability ranking (dw-oracle, then dw-oracle-2nd through configured later slots) | xhigh minimum for GPT/Codex review routes; preserve native max when explicitly selected and supported | dw-oracle*, dw-oracle-2nd*, dw-oracle-3rd*... |
| Plan review | Same primary reasoning lane when directly configurable | xhigh minimum; local max only by explicit local configuration | dw-plan-critic |
| Mid | Best available mid-tier model; if none exists, use the primary reasoning model at a lower effort | Preserve the profile baseline unless task complexity requires more | dw-complex, dw-normal-task, dw-coding, dw-research, dw-frontend, dw-creative, dw-documenting, dw-media-reader, dw-doc-search |
| Mini | Best available lightweight model for mechanical, search, or fast lookup work | high for accuracy unless the user explicitly configures otherwise | dw-quick, dw-code-search, dw-explore |
When a newer family is explicitly available, select a demonstrably better model in the same capability lane instead of pinning an example name. Keep the role's high/xhigh/max complexity rule, never override an explicit user model, and fall back to the generated profile default when availability or capability evidence is absent.
Reviewer and Oracle routes use an xhigh-equivalent minimum when the selected model family exposes that control; otherwise they use the highest supported review effort for that family. GPT-5.6 supports native max, so complex or high-risk review/verification on a GPT-5.6 selected model may request max directly. Other families use max only when their cataloged controls support it.
The plan-critic profile uses xhigh minimum; raise it only through explicit local configuration.
dw-oracle (logical tiers: normal)dw-oracle-2nd (logical tiers: normal)Slot ordering is always by Oracle ordinal (oracle, oracle-2nd, oracle-3rd, ...). Logical tier choice never reorders slots.
dw-oracle, then dw-oracle-2nd through later configured slots.normal; configured -low, -high, and -max profiles select task rigor independently of slot priority.high, falling back to unsuffixed normal when high is absent.max, otherwise configured high, otherwise unsuffixed normal.low is selected only by an explicit user/workflow cost-or-latency request and still receives the review-effort floor.| Tier | Agents | Model | Effort |
|---|---|---|---|
| Flagship | dw-orchestrator, dw-planner, dw-builder, dw-clarifier, dw-deep, dw-hard-reasoning | Primary reasoning model from the user's available catalog | xhigh minimum for planner/deep/hard-reasoning; native max for GPT-5.6 maximum-reasoning work. high only for coordination, implementation, or clarification roles below that threshold |
| External review | dw-reviewer | Primary reasoning lane | xhigh-equivalent minimum when supported; native max for GPT-5.6 complex or high-risk review |
| Ordered Oracle review | dw-oracle, dw-oracle-2nd, later configured Oracle slots | Ordered by Oracle slot ordinal; tier choice does not reorder slots | xhigh-equivalent minimum when supported; native max for GPT-5.6 complex or high-risk verification |
| Plan review | dw-plan-critic | Primary reasoning lane | xhigh minimum unless local config raises it |
| Mid | dw-complex, dw-normal-task, dw-coding, dw-research, dw-frontend, dw-creative, dw-documenting, dw-media-reader, dw-doc-search | Available mid-tier model, else primary reasoning model at lower effort | max or high by task shape |
| Mini | dw-quick, dw-code-search, dw-explore | Available lightweight model | high |
high effort instead.Oracle and Reviewer profiles are selectable options, not automatic fan-out. Choose exactly the profiles required by risk/complexity and dispatch only those selections.
dw-plan-critic provides receipt-focused plan review through the Plan review lane at xhigh minimum.
Reviewer and Oracle routes use an xhigh-equivalent minimum when the selected model family exposes that control; otherwise they use the highest supported review effort for that family. GPT-5.6 supports native max; for other families, request max only when the selected model and catalog expose a maximum-effort control.
Concrete model names in docs, tests, or generated profile comments are examples and compatibility references only. Select from the user's currently available model catalog and explicit local configuration; never require a specific example name or provider channel.