Paths: File paths (

shared/

,

references/

,

../ln-*

) are relative to skills repo root.

Type: L3 Worker Category: 3XX Planning

Review Research Worker

Structured research worker for validation, audit, and review flows.

Mandatory Read

MANDATORY READ: Load

shared/references/evaluation_worker_runtime_contract.md

,

shared/references/evaluation_summary_contract.md

,

shared/references/evaluation_research_contract.md

,

shared/references/epistemic_protocol.md

Purpose

• gather official documentation or standards
• gather MCP Ref evidence
• gather Context7 evidence when a library or framework is involved
• gather current web best-practice evidence
• emit a compact machine-readable research summary instead of prose-only notes

Runtime

Runtime family:

• evaluation-worker-runtime

Required manifest fields:

• identifier

• phase_order

• summary_kind=review-research

• operation=research

Recommended

phase_order

:

1. PHASE_0_CONFIG

2. PHASE_1_RESOLVE_STACK

3. PHASE_2_OFFICIAL_DOCS

4. PHASE_3_MCP_REF

5. PHASE_4_CONTEXT7

6. PHASE_5_WEB_BEST_PRACTICES

7. PHASE_6_ANTI_HALLUCINATION

8. PHASE_7_WRITE_SUMMARY

9. PHASE_8_SELF_CHECK

Workflow

Phase 0: Config

1. Load runtime manifest.
2. Resolve review target, stack hints, and output location.
3. Fail if target context is missing.

Phase 1: Resolve Stack

1. Detect language, framework, libraries, and domain.
2. Build a bounded research topic list.
3. Keep topic count small and evidence-oriented.

Phase 2: Official Docs

1. Read official docs or standards first.
2. Record source URLs and the exact topic each source supports.

Phase 3: MCP Ref

1. Query MCP Ref for the same bounded topics.
2. Prefer primary documentation over tertiary commentary.

Phase 4: Context7

1. If a library or framework is involved, resolve the Context7 library id.
2. Query only the libraries actually used by the target.
3. If no relevant library exists, record that explicitly.

Phase 5: Web Best Practices

1. Perform current web research for best practices and recent changes.
2. Use current sources, not frozen heuristics.
3. Record only evidence that changes a conclusion or adds decision value.

Phase 6: Anti-Hallucination Verification

1. Scan target artifact for factual claims across all trigger categories per

   epistemic_protocol.md

   Section B.
2. For each claim, check against research evidence gathered in Phases 2-5:
   • Has MCP Ref/Context7/Web evidence → mark

     VERIFIED

   • No tool evidence but claim is plausible → mark

     FROM_TRAINING

   • Contradicts tool evidence → mark

     FLAGGED

     (CRITICAL)
3. This step verifies against existing research. It does NOT run new searches.
4. Include verification status in summary metadata.

Phase 7: Write Summary

Emit

summary_kind=review-research

.

Payload must include:

• worker=ln-311

• status

• operation=research

• warnings

Prefer these fields when available:

• findings

• metrics.research_sources

• metrics.anti_hallucination_status

  (VERIFIED | FLAGGED)

• metrics.flagged_claims_count

• artifact_path

• report_path

• metadata

Phase 8: Self-Check

1. Verify all four research lanes were attempted.
2. Verify anti-hallucination verification was executed.
3. Verify skipped lanes are justified in machine-readable form.
4. Record

   pass=true

   only after the summary is written.

Definition of Done

• Official-doc evidence recorded
• MCP Ref evidence recorded
• Context7 evidence recorded or justified as not applicable
• Current web best-practice evidence recorded
• Anti-hallucination verification executed (claims marked VERIFIED/FROM_TRAINING/FLAGGED)

• review-research

  summary written
• Self-check passed

Version: 1.0.0 Last Updated: 2026-04-10