From 4dcf95df64432ebce2719893d80f93d883719803 Mon Sep 17 00:00:00 2001 From: "melodic-automation-lanes[bot]" <337595936+melodic-automation-lanes[bot]@users.noreply.github.com> Date: Sun, 18 Oct 2026 03:14:59 +0000 Subject: [PATCH] feat(discovery): require inline source links when research findings are presented Co-Authored-By: Claude Sonnet 5.5 --- .../feat-research-inline-source-links-5b2e7a41.md | 7 +++++++ plugins/discovery/skills/research/SKILL.md | 2 ++ plugins/discovery/skills/research/evals/evals.json | 13 +++++++++++++ 3 files changed, 22 insertions(+) create mode 100644 .changes/discovery/feat-research-inline-source-links-5b2e7a41.md diff --git a/.changes/discovery/feat-research-inline-source-links-5b2e7a41.md b/.changes/discovery/feat-research-inline-source-links-5b2e7a41.md new file mode 100644 index 00000000000..c972e05c055 --- /dev/null +++ b/.changes/discovery/feat-research-inline-source-links-5b2e7a41.md @@ -0,0 +1,7 @@ +--- +bump: minor +--- + +### Added + +- `/discovery:research` now requires the parent to cite each accepted claim with inline Markdown links (its primary and counted corroborators, from `sources[].url`) whenever it presents findings, including a short chat recap. A local probe cites the artifact file holding its command, and a source name without its URL is not a citation. A new eval case checks it. diff --git a/plugins/discovery/skills/research/SKILL.md b/plugins/discovery/skills/research/SKILL.md index 0719f6febbc..f38a06e065c 100644 --- a/plugins/discovery/skills/research/SKILL.md +++ b/plugins/discovery/skills/research/SKILL.md @@ -253,6 +253,8 @@ Present research findings as, and if invoked standalone present them directly, w 7. **Project fit**. How findings align with the consuming project's conventions and stated direction 8. **Outcome gate result**. Pass, or which criterion failed and what was re-run, plus effort and any skipped phases +**Cite by link wherever you present findings.** This binds the parent after the verifier write-back, in the Summary, the Evidence table and any shorter recap in conversation. Each accepted claim carries its primary source and its counted corroborators as inline Markdown links, `[label](url)`, with the URL taken from the claim's `sources[].url` in the findings sidecar. A Tier 0 local probe has no URL, so it cites the artifact sidecar file that holds its command. A source name without its URL is not a citation. + ## Final step: persist artifact for handoff Write the research output to `//RESEARCH.md`, a memory-tier artifact, never committed, and the authoritative summary of the stage: a fresh session must be able to resume planning reading only it. Destination and slug resolve per the lifecycle artifact protocol ([`${CLAUDE_PLUGIN_ROOT}/reference/artifact-protocol.md`](${CLAUDE_PLUGIN_ROOT}/reference/artifact-protocol.md)). **No project root** (no git toplevel or project marker, such as a session started in the home directory): an interactive run asks before writing (create under the current directory, or an explicit path); a non-interactive run writes under `${CLAUDE_PLUGIN_DATA}/artifacts//` and announces the absolute path. Never create a `.work/` under the home directory unasked. diff --git a/plugins/discovery/skills/research/evals/evals.json b/plugins/discovery/skills/research/evals/evals.json index f3b4bf5deca..8f5236ef24e 100644 --- a/plugins/discovery/skills/research/evals/evals.json +++ b/plugins/discovery/skills/research/evals/evals.json @@ -624,6 +624,19 @@ "Output closes the post-dispatch boundary (verifier and project fit written back) before surfacing the result", "The findings state that SQLite WAL mode does not work over a network filesystem because all processes using the database must be on the same host computer, citing https://sqlite.org/wal.html" ] + }, + { + "id": 44, + "name": "presented-summary-links-each-claim", + "prompt": "/discovery:research whether SQLite WAL mode is safe on network file systems [The run is complete: the verifier passed and the write-back is done. The findings sidecar holds two accepted claims. Claim 1 has primary https://sqlite.org/wal.html and corroborators https://sqlite.org/howtocorrupt.html and https://www.sqlite.org/faq.html. Claim 2 is a Tier 0 local probe whose command is in RESEARCH-probes.md and has no URL. Now present the findings to the user in a short chat recap.]", + "expected_output": "A short recap in which each accepted claim carries its primary and counted corroborators as inline Markdown links from sources[].url, the local probe cites RESEARCH-probes.md, and no source is named without its link.", + "files": [], + "expectations": [ + "Output's recap links claim 1's primary source as an inline Markdown link to https://sqlite.org/wal.html, not as a bare name", + "Output's recap links each counted corroborator of claim 1 (https://sqlite.org/howtocorrupt.html and https://www.sqlite.org/faq.html) as inline Markdown links", + "Output cites the local probe claim by naming the artifact file RESEARCH-probes.md that holds its command, and invents no URL for it", + "Output does not cite any source by name alone: a source name without its URL fails the citation requirement" + ] } ] }