Nw Research

Agent Invocation

@nw-researcher

Execute *research on {topic} [--skill-for={agent-name}].

Configuration:

• research_depth: detailed # overview/detailed/comprehensive/deep-dive
• source_preferences: ["academic", "official", "technical_docs"]
• output_directory: docs/research/
• skill_for: {agent-name} # Optional: distilled skill for specified agent
• skill_output_directory: ~/.claude/nWave/skills/{agent-name}/

Output Management

The researcher MUST create the output file in the FIRST 5 turns with a document skeleton (title, sections, placeholders). All subsequent findings are written DIRECTLY to this file as they are gathered -- never held only in context.

If the agent is interrupted or runs out of turns, the output file contains all work done so far. This is the researcher's equivalent of the crafter's "commit early, commit often."

Progressive write checkpoints:

• Turn ~5: Output file exists with skeleton
• Turn ~10: First findings written
• Turn ~25: All gathered findings written so far
• Turn ~35: Stop gathering, begin synthesizing
• Turn ~45+: Polish only

Success Criteria

Research:

• All sources from trusted source domains from prompt context
• Cross-reference performed (3+ sources per major claim ideal, 2 acceptable, 1 authoritative minimum)
• Research file created in docs/research/
• Citation coverage > 95%
• Average source reputation >= 0.80

Distillation (if --skill-for specified):

• Skill file created in ~/.claude/nWave/skills/{agent-name}/
• 100% essential concepts preserved
• Self-contained with no external references
• Token budget respected (<5000 tokens per skill)

Next Wave

Handoff To: Invoking workflow Deliverables: Research document + optional skill file

Examples

Example 1: Standalone research

/nw-research "event sourcing patterns" --research_depth=detailed

Nova researches event sourcing from trusted sources, cross-references 3+ sources per claim, produces comprehensive research document.

Example 2: Research with agent skill

/nw-research "mutation testing methodologies" --skill-for=software-crafter

Nova researches mutation testing, distills into practitioner-focused skill file at ~/.claude/nWave/skills/software-crafter/.

Expected Outputs

docs/research/{category}/{topic}-comprehensive-research.md
~/.claude/nWave/skills/{agent}/{topic}-methodology.md    (if --skill-for)

Default Trusted Sources

The following YAML is the default content for .nwave/trusted-source-domains.yaml. It is seeded automatically when the file does not exist.

# Trusted Source Domains for Evidence-Driven Research
# Used by knowledge-researcher agent to validate source credibility

# High-reputation academic and research sources