save_finding
Save critical research findings, insights, and discoveries to a persistent library. Automatically detects duplicates to keep your knowledge base organized and accessible.
Instructions
Save critical research findings, discoveries, and insights to persistent library.
AUTOMATIC TRIGGERS - Call this when:
You discover important factual information during research
You complete an analysis with actionable insights
You find evidence supporting or refuting a hypothesis
You learn something new about the codebase or project
User shares important information that should be remembered
DO NOT CALL for:
Temporary working notes
Process updates or progress reports
Conversation summaries
Tool execution results (unless they contain novel insights)
WORKFLOW POSITION: Call after discovering insights, before ending session. Save findings as you go - don't wait until the end.
READ-BEFORE-WRITE: This tool automatically checks for similar findings before saving. If a very similar finding exists (similarity > 0.90), it will be returned as a suggestion instead of saving a duplicate. Consider updating the existing finding instead.
SESSION AWARENESS: For best results, use start_research or session_start before saving findings. This enables automatic context injection and session-based knowledge tracking. If no active session is detected, a warning will be returned.
CONFIRMATION TIER: WRITE OPERATION - Requires confirm=True. This creates persistent data. Set confirm=true for final saves, confirm=false for drafts.
PARAMETERS:
project: Project name for categorization (required)
claim: The finding/insight text (required) - be specific and actionable
confidence: Confidence level 0.0-1.0 (default: 0.8). Use 0.9 for definitive findings, 0.7 for tentative, 0.5 for hypotheses
evidence: Supporting evidence strings (optional) - quotes, data points, references
reasoning: Your reasoning behind the finding (optional but recommended)
caveats: Limitations or cave (optional)
tags: Tags for categorization (optional) - use consistent tags
confirm: Must be True to save (safety gate). Use False for drafts.
TIP: If a similar finding already exists, consider updating it instead of creating a duplicate. Use search_findings first to check for duplicates.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | ||
| claim | Yes | ||
| caveats | No | ||
| confirm | No | ||
| project | Yes | ||
| evidence | No | ||
| full_text | No | ||
| reasoning | No | ||
| confidence | No | ||
| finding_id | No | ||
| proposed_by | No |