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)
|
||||
- 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.
|
||||
</role>
|
||||
|
||||
<project_context>
|
||||
@@ -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]**
|
||||
|
||||
Reference in New Issue
Block a user