From e24add196cd25a7a01dd6bb9b0e0bbffa2b0bde7 Mon Sep 17 00:00:00 2001 From: Tibsfox Date: Fri, 27 Mar 2026 17:42:53 -0700 Subject: [PATCH] feat(researcher): add claim provenance tagging and assumptions log MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Research agents must now tag every factual claim with its source: [VERIFIED], [CITED], or [ASSUMED]. An Assumptions Log section in RESEARCH.md collects all [ASSUMED] claims so downstream agents and users can identify decisions that need confirmation before execution. Prevents unvalidated assumptions (e.g. "audit logs should be permanent") from propagating unchallenged through research → planning → execution. Closes #1431 Co-Authored-By: Claude Opus 4.6 (1M context) --- agents/gsd-phase-researcher.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/agents/gsd-phase-researcher.md b/agents/gsd-phase-researcher.md index 28a7a00f3..8c5f6e398 100644 --- a/agents/gsd-phase-researcher.md +++ b/agents/gsd-phase-researcher.md @@ -25,6 +25,13 @@ If the prompt contains a `` block, you MUST use the `Read` tool t - Document findings with confidence levels (HIGH/MEDIUM/LOW) - Write RESEARCH.md with sections the planner expects - Return structured result to orchestrator + +**Claim provenance (CRITICAL):** Every factual claim in RESEARCH.md must be tagged with its source: +- `[VERIFIED: npm registry]` — confirmed via tool (npm view, web search, codebase grep) +- `[CITED: docs.example.com/page]` — referenced from official documentation +- `[ASSUMED]` — based on training knowledge, not verified in this session + +Claims tagged `[ASSUMED]` signal to the planner and discuss-phase that the information needs user confirmation before becoming a locked decision. Never present assumed knowledge as verified fact — especially for compliance requirements, retention policies, security standards, or performance targets where multiple valid approaches exist. @@ -343,6 +350,17 @@ Verified patterns from official sources: **Deprecated/outdated:** - [Thing]: [why, what replaced it] +## Assumptions Log + +> List all claims tagged `[ASSUMED]` in this research. The planner and discuss-phase use this +> section to identify decisions that need user confirmation before execution. + +| # | Claim | Section | Risk if Wrong | +|---|-------|---------|---------------| +| A1 | [assumed claim] | [which section] | [impact] | + +**If this table is empty:** All claims in this research were verified or cited — no user confirmation needed. + ## Open Questions 1. **[Question]**