From 01b6c24a5738b836026fc71b18b1bb3d38cc9b56 Mon Sep 17 00:00:00 2001 From: Kyle Merritt Date: Sat, 14 Nov 2026 10:34:52 -0500 Subject: [PATCH 1/3] Extract Planner research methodology for #1032 --- README.md | 2 ++ packages/research-auto/SKILL.md | 13 +++++++++++++ packages/research-auto/relayview-skill.json | 15 +++++++++++++++ tests/test_packages.py | 9 +++++++++ 4 files changed, 39 insertions(+) create mode 100644 packages/research-auto/SKILL.md create mode 100644 packages/research-auto/relayview-skill.json diff --git a/README.md b/README.md index 9b56734..ca651e4 100644 --- a/README.md +++ b/README.md @@ -99,3 +99,5 @@ communication treatment is off. Unrelated automatic packages remain available. The owner retains publication identity/order, mandatory status, complete durable artifacts, verification and Operator acceptance. These packages customize answer/detail/example/acknowledgement presentation only. + +The automatic `research-auto` Planner package supplies primary-source selection, preferred-domain exploration/refinement and evidence-reading methodology. The manual `research` package remains available on request. Tool arguments, budgets, continuation, recovery and untrusted research provenance belong to the owner. diff --git a/packages/research-auto/SKILL.md b/packages/research-auto/SKILL.md new file mode 100644 index 0000000..9a4e7e8 --- /dev/null +++ b/packages/research-auto/SKILL.md @@ -0,0 +1,13 @@ +--- +name: research-auto +description: Source selection and reading methods for assigned Planner research. +metadata: + relayview-display-name: Research methodology + relayview-version: 0.12.0 +--- + +# Research methodology + +Prefer primary sources: the official specification, documentation, or source repository that owns a claim. When an applicable authoritative domain is already known, preferredDomains may rank it higher; omit the option during broad exploration and refine a later search after discovering the right domain. Prefer narrow publisher hosts over broad multi-tenant hosts, and inspect/fetch returned sources before relying on them. + +Record source locations and observed versions or dates for claims that may change. Label inferences and unresolved facts. Put concise findings and citations in the planning response so the Plan can use them. diff --git a/packages/research-auto/relayview-skill.json b/packages/research-auto/relayview-skill.json new file mode 100644 index 0000000..b9f5fe4 --- /dev/null +++ b/packages/research-auto/relayview-skill.json @@ -0,0 +1,15 @@ +{ + "schemaVersion": 1, + "source": { + "kind": "first-party", + "reference": "v0.12.0" + }, + "role": "planner", + "step": "planning", + "files": [ + { + "path": "SKILL.md", + "sha256": "a3acca3ed412dc0e8351d82d7e201ef6112bf3a68142f06e570bd29a71391b22" + } + ] +} diff --git a/tests/test_packages.py b/tests/test_packages.py index c772be1..74dd3e6 100644 --- a/tests/test_packages.py +++ b/tests/test_packages.py @@ -12,6 +12,15 @@ ROOT = Path(__file__).resolve().parents[1] class PackageTests(unittest.TestCase): + def test_research_auto_contains_only_extracted_method(self): + package = ROOT / "packages/research-auto" + check_package(package) + text = (package / "SKILL.md").read_text() + self.assertIn("omit the option during broad exploration", text) + self.assertIn("inspect/fetch returned sources", text) + self.assertNotIn("spawn", text) + self.assertNotIn("save a research file", text) + def test_communication_packages_declare_their_treatment(self): for role in ("planner", "implementer", "reviewer"): package = ROOT / f"packages/{role}-communication" From 015b4d1d0edcc9d831da036bdf915f41fc56a07e Mon Sep 17 00:00:00 2001 From: Kyle Merritt Date: Sat, 14 Nov 2026 10:40:33 -0500 Subject: [PATCH 2/3] Keep automatic research within approved extraction scope --- packages/research-auto/SKILL.md | 4 +--- packages/research-auto/relayview-skill.json | 4 ++-- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/packages/research-auto/SKILL.md b/packages/research-auto/SKILL.md index 9a4e7e8..678ff6b 100644 --- a/packages/research-auto/SKILL.md +++ b/packages/research-auto/SKILL.md @@ -3,11 +3,9 @@ name: research-auto description: Source selection and reading methods for assigned Planner research. metadata: relayview-display-name: Research methodology - relayview-version: 0.12.0 + relayview-version: 0.12.1 --- # Research methodology Prefer primary sources: the official specification, documentation, or source repository that owns a claim. When an applicable authoritative domain is already known, preferredDomains may rank it higher; omit the option during broad exploration and refine a later search after discovering the right domain. Prefer narrow publisher hosts over broad multi-tenant hosts, and inspect/fetch returned sources before relying on them. - -Record source locations and observed versions or dates for claims that may change. Label inferences and unresolved facts. Put concise findings and citations in the planning response so the Plan can use them. diff --git a/packages/research-auto/relayview-skill.json b/packages/research-auto/relayview-skill.json index b9f5fe4..0422ae3 100644 --- a/packages/research-auto/relayview-skill.json +++ b/packages/research-auto/relayview-skill.json @@ -2,14 +2,14 @@ "schemaVersion": 1, "source": { "kind": "first-party", - "reference": "v0.12.0" + "reference": "v0.12.1" }, "role": "planner", "step": "planning", "files": [ { "path": "SKILL.md", - "sha256": "a3acca3ed412dc0e8351d82d7e201ef6112bf3a68142f06e570bd29a71391b22" + "sha256": "235b41d631c6d7e65b24fc902170ec8beb4c0a6b5ed2ff9b70d30bec6c9db58f" } ] } From 86cf1b6f8173754897ce759bf04ec991fa494911 Mon Sep 17 00:00:00 2001 From: Kyle Merritt Date: Sat, 14 Nov 2026 11:21:38 -0500 Subject: [PATCH 3/3] Include existing launch-policy research methods in automatic guidance --- README.md | 2 +- packages/research-auto/SKILL.md | 16 ++++++++++++++-- packages/research-auto/relayview-skill.json | 4 ++-- tests/test_packages.py | 2 ++ 4 files changed, 19 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index ca651e4..099ad2f 100644 --- a/README.md +++ b/README.md @@ -100,4 +100,4 @@ The owner retains publication identity/order, mandatory status, complete durable artifacts, verification and Operator acceptance. These packages customize answer/detail/example/acknowledgement presentation only. -The automatic `research-auto` Planner package supplies primary-source selection, preferred-domain exploration/refinement and evidence-reading methodology. The manual `research` package remains available on request. Tool arguments, budgets, continuation, recovery and untrusted research provenance belong to the owner. +The automatic `research-auto` Planner package supplies primary-source selection, preferred-domain exploration/refinement and evidence-reading methodology, publication/version checking, corroboration and already-admitted empirical evidence methods. The manual `research` package remains available on request. Tool arguments, budgets, continuation, recovery and untrusted research provenance belong to the owner. diff --git a/packages/research-auto/SKILL.md b/packages/research-auto/SKILL.md index 678ff6b..7418c44 100644 --- a/packages/research-auto/SKILL.md +++ b/packages/research-auto/SKILL.md @@ -3,9 +3,21 @@ name: research-auto description: Source selection and reading methods for assigned Planner research. metadata: relayview-display-name: Research methodology - relayview-version: 0.12.1 + relayview-version: 0.12.2 --- # Research methodology -Prefer primary sources: the official specification, documentation, or source repository that owns a claim. When an applicable authoritative domain is already known, preferredDomains may rank it higher; omit the option during broad exploration and refine a later search after discovering the right domain. Prefer narrow publisher hosts over broad multi-tenant hosts, and inspect/fetch returned sources before relying on them. +Prefer primary sources: applicable official documentation, specifications, source code, release notes, maintainer records, and reproducible first-party artifacts that own a claim; use secondary sources for orientation and corroboration. When an applicable authoritative domain is already known, preferredDomains may rank it higher; omit the option during broad exploration and refine a later search after discovering the right domain. Prefer narrow publisher hosts over broad multi-tenant hosts, and inspect/fetch returned sources before relying on them. + +When external research is material, use web_search to discover candidate public sources before web_fetching selected applicable evidence instead of guessing a destination URL. + +Check publication date, applicable product and version, and whether a source supports the precise claim. State uncertainty, conflicts, missing access, and inferences explicitly. + +Corroborate consequential or surprising claims with independent evidence when practical; mirrors, syndication, repetition, and pages derived from one upstream source are not independent. + +For an empirically testable technical claim, prefer a small reproducible local experiment only when this role already has an approved execution capability. Record the question, procedure, relevant versions and resolved paths, observation, and limitations; do not generalize beyond the tested environment. + +Use confidence language proportional to the evidence and identify claims that still depend on provider ranking, inaccessible sources, or unverified assumptions. + +Repeat an exact query only when the cached result is intentionally sufficient; use a materially narrower query when new terms, version, claim, or source scope justify a distinct auditable search. diff --git a/packages/research-auto/relayview-skill.json b/packages/research-auto/relayview-skill.json index 0422ae3..be9ac90 100644 --- a/packages/research-auto/relayview-skill.json +++ b/packages/research-auto/relayview-skill.json @@ -2,14 +2,14 @@ "schemaVersion": 1, "source": { "kind": "first-party", - "reference": "v0.12.1" + "reference": "v0.12.2" }, "role": "planner", "step": "planning", "files": [ { "path": "SKILL.md", - "sha256": "235b41d631c6d7e65b24fc902170ec8beb4c0a6b5ed2ff9b70d30bec6c9db58f" + "sha256": "112036daeb1f760093345805b8c17b1f385723f3597608cf8ad19d72023ccd74" } ] } diff --git a/tests/test_packages.py b/tests/test_packages.py index 74dd3e6..22d6370 100644 --- a/tests/test_packages.py +++ b/tests/test_packages.py @@ -18,6 +18,8 @@ class PackageTests(unittest.TestCase): text = (package / "SKILL.md").read_text() self.assertIn("omit the option during broad exploration", text) self.assertIn("inspect/fetch returned sources", text) + self.assertIn("Check publication date", text) + self.assertIn("Corroborate consequential", text) self.assertNotIn("spawn", text) self.assertNotIn("save a research file", text)