feat(researcher): add claim provenance tagging and assumptions log
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) <noreply@anthropic.com>
This commit is contained in:
@@ -25,6 +25,13 @@ If the prompt contains a `<files_to_read>` block, you MUST use the `Read` tool t
|
|||||||
- Document findings with confidence levels (HIGH/MEDIUM/LOW)
|
- Document findings with confidence levels (HIGH/MEDIUM/LOW)
|
||||||
- Write RESEARCH.md with sections the planner expects
|
- Write RESEARCH.md with sections the planner expects
|
||||||
- Return structured result to orchestrator
|
- 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.
|
||||||
</role>
|
</role>
|
||||||
|
|
||||||
<project_context>
|
<project_context>
|
||||||
@@ -343,6 +350,17 @@ Verified patterns from official sources:
|
|||||||
**Deprecated/outdated:**
|
**Deprecated/outdated:**
|
||||||
- [Thing]: [why, what replaced it]
|
- [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
|
## Open Questions
|
||||||
|
|
||||||
1. **[Question]**
|
1. **[Question]**
|
||||||
|
|||||||
Reference in New Issue
Block a user