researchforge-landscape · git:20260713.896358d · 2026-07-13 · sha256 d6c85384721999d4

researchforge-landscape git:20260713.896358dA

Immutable. This exact content never changes and is served at /api/v1/blob/d6c85384721999d4.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_sm3yiymblxt5blp3/d6c85384721999d4da1aa5c0e7f589d7a43ec925604ca9a4beea654e010bb6b5.json

Then /plugin install researchforge-landscape@markdownregistry-sm3yiymblxt5blp3 in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: researchforge-landscape
description: Synthesize stored papers into a research landscape — grouped directions with evidence claims — and import it for validation. Use after papers are stored, when the user wants directions, themes, or a map of the literature.
---

# Build the research landscape

This is a handshake: the engine exports structured context, you write the
synthesis as YAML, the engine validates it field-by-field before anything is
stored. Your synthesis must be grounded in the exported papers only.

## 1. Export context

```bash
researchforge research context --json
```

This writes `.researchforge/synthesis/context.json`: the objective, the
stored papers (id, title, abstract, ranking signals), and — critically — the
embedded JSON Schema the artifact must conform to. Read the whole file.

## 2. Write the landscape

Write `.researchforge/synthesis/landscape.yaml` conforming exactly to the
embedded schema. Requirements the validator will enforce:

- every `cited_paper_ids` entry must be a stored paper id from the context;
- every direction needs evidence claims that distinguish **claims made by a
  paper** from **your interpretation** (`evidence_type`), each with an
  `extraction_confidence`;
- do not cite papers for statements their abstracts cannot support.

## 3. Import (engine validates)

```bash
researchforge research landscape --import .researchforge/synthesis/landscape.yaml --json
```

If validation fails, the `--json` error payload lists field-level errors
(path, message, offending value). Re-read the error payload, fix exactly
those fields in the YAML, and re-import. Never bypass validation by editing
stored files directly.

Next: the researchforge-hypotheses skill turns directions into testable
hypotheses.

## Rules

- The Python engine is the boundary: never work around a validation error, a
  protected path, or an approval gate — fix the artifact or ask the user.
- Approvals belong to the user: never pass `--yes` or type a confirmation
  unless the user explicitly approved that step in this conversation.
- Ground every summary in stored data: quote only numbers returned by
  `--json` output or files under `.researchforge/` — never invent metrics.