save_annotation
Save AI-written summaries and keywords for a source file to make BM25 keyword search semantic, helping natural-language queries find relevant code without embeddings.
Instructions
Saves an AI-authored annotation (summary + keywords) for a source file.
Annotations make keyword search semantic WITHOUT embeddings: your summary
is indexed into BM25, so natural-language queries like "where is auth
handled" match it. Write annotations for files you have just read or
changed — 1-2 sentences on what the file does and why it exists.
Args:
path: File path relative to project root (or absolute inside it).
summary: 1-3 sentences: purpose, key responsibilities, notable design.
keywords: Comma-separated search terms a developer might query
(synonyms, domain words not present in identifiers).
Returns:
Confirmation with annotation coverage stats.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>",
"summary": "<summary>"
},
"name": "save_annotation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| summary | Yes | ||
| keywords | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |