/nw-role-invocation

name: nw-role-invocation
description: "KNOWLEDGE — how a wave entrypoint invokes its specialist: the real installed role definition, never a generic persona. Load when a wave delegates to a role."
user-invocable: false
disable-model-invocation: true

nw-role-invocation (KNOWLEDGE)

Reference for wave entrypoints. The LLM chooses waves and operations; nwdes constructs handoffs, briefs, prompts and packets without workflow state or progression.

Rule

Delegate to the exact installed role definition (`nw-<role>`), with its real instructions and mandatory frontmatter skills. Missing mandatory instructions stop delegation; never substitute a generic persona. Conditional skills load on the role's own triggers. The LLM/native host owns model execution, provider/model/effort selection and orchestration. nwdes never launches a model.

Load `nw-cross-cutting-invariants` and apply `flow:findings-go-to-the-owner-directly`, including its dispatch-task instruction for every relevant role.

Invocation forms

For native delegation, select the installed specialist in the host tool: Claude `Agent(subagent_type="nw-solution-architect", prompt=...)`; Codex `spawn_agent(agent_type="nw-solution-architect", message=...)`. Substitute the exact role below, and pass the bounded task and its evidence. Do not select a generic agent and replace its definition with persona prose. The host's native tool may be named `Agent` or `Task`; use whichever it supports to select the exact installed role, with only parameters it supports. The wave caller invokes the role; the role does the semantic work and records its values through its nwdes verbs. If native delegation cannot start it with its declared tools ceiling, use a supported native CLI invocation or report the missing capability. Never substitute a generic worker or grant extra tools.

Read `nw-nwdes` for the current role/task mapping. Build the exact role's task with `nwdes prompt` and pass its output verbatim. Put bounded host context in `--root-context` only for recipes that admit it; examine refuses it and both host observation flags before any read or effect.

| Need | Exact installed role | Role-owned recording | |---|---|---| | Product decomposition | `nw-product-owner` | `nwdes product` record edits, `nwdes product close` | | Expectation charter | `nw-product-owner --task charter` | `nwdes charter set`, `charter positive add`, `charter close` | | Solution architecture | `nw-solution-architect` | `nwdes design` record edits, `nwdes design close` | | Acceptance oracle | `nw-acceptance-designer` | `nwdes acceptance row add`, `close`; host observes declared RED | | Implementation | `nw-software-crafter` / `nw-functional-software-crafter` | `nwdes craft file add`, `command add`, `close`; host observes declared GREEN | | Independent review | `nw-software-crafter-reviewer` / `nw-acceptance-designer-reviewer` | Follow [Review evidence](#review-evidence) in the generated subject/slice scope | | Expectations / EXAMINE | `nw-user-examiner` | `nwdes expectations row add/close` or `nwdes examine verdict set/close` | | Operational facts | `nw-platform-architect` | Give semantic operational facts to the solution architect, who records the design values |

The bound functional paradigm selects `nw-functional-software-crafter`; otherwise use the ordinary crafter. Do not infer a new paradigm from the launcher or host language.

Selected independent operational review

When the authorized DESIGN or DEVOPS task selects independent platform review, the native wave caller invokes `nw-platform-architect-reviewer` on the actual current operational authority, its bound facts, authorized scope and available observations. Use the existing native invocation form and the reviewer's declared ceiling; no producer judgment substitutes for its result.

This is caller-owned orchestration, not a new review-task payload or builder operation. Add no delegation/reviewer/result fields to the design payload. Consume the actual verdict and findings; required revisions or unresolved load-bearing evidence remain with the platform authority owner. A configured or human-authorized skip is skipped, never approved. Builder success does not establish review approval or authorize rollout.

Reuse adequate authority without a new producer turn; do not add a review for a no-op when none is selected. Missing exact-role invocation capability is explicit, never a generic substitute or invented result.

Role-owned recording

`nwdes prompt` includes the generated verb reference for the selected role. Every recording invocation names its kind and scope. The role records semantic values with typed `add`/`set`/`remove` flags; the first such call creates the scoped draft. It then calls `close --outcome ... --diagnostic ...`. nwdes constructs ids, structure, paths and serialization. The host passes no envelope and copies no reply into another command. The prompt binds repository, feature and applicable slice scope. Use the generated reference for required selectors; keep the same scope throughout the draft. Slash-separated verb lists describe separate calls, not one command. Run every nwdes command from the top level of the checkout. Roots default to cwd and the repository root; lane verbs resolve the main worktree. Close with no draft validates empty values.

Every role, including the Product Owner and examiner, records through the nwdes CLI using Bash. They work from the user's point of view and have no need to inspect code; this is a task focus, not a code-access prohibition. The host supplies the generated prompt, not a substitute recording channel.

For an authority correction, the owning role uses `open --from-current`, edits the retained records and closes again. A close refusal retains the draft and leaves authority unchanged. Give the refusal's WHAT/WHY/HOW unchanged to that role, or fulfill its named host-owned prerequisite and rebuild the prompt if inputs changed. The host does not repai