Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -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.
2 changes: 2 additions & 0 deletions plugins/discovery/skills/research/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<memory_dir>/<slug>/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/<slug>/` and announces the absolute path. Never create a `.work/` under the home directory unasked.
Expand Down
13 changes: 13 additions & 0 deletions plugins/discovery/skills/research/evals/evals.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
]
}
]
}
Loading