file_bug
Capture bug symptoms, root cause, and fix after resolving an issue, then store them in a searchable knowledge base for future sessions.
Instructions
Save a newly discovered bug to the knowledge base. Call this AFTER solving a hard bug to capture the knowledge for future sessions. The file is written to code_failures/bugs/ and auto-indexed.
IMPORTANT: Show the user the generated content and get confirmation before calling.
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": {
"library": "<library>",
"shortName": "<shortName>",
"title": "<title>",
"symptom": "<symptom>",
"rootCause": "<rootCause>",
"fix": "<fix>"
},
"name": "file_bug"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fix | Yes | Working solution with code examples | |
| tags | No | Tags for searchability | |
| title | Yes | Bug title (e.g. 'useCopilotChat returns undefined visibleMessages') | |
| library | Yes | Library/package name (e.g. 'copilotkit', 'starlette') | |
| symptom | Yes | What you observe — error messages, broken behavior | |
| severity | No | Bug severity | |
| rootCause | Yes | Why it happens — the underlying mechanism | |
| shortName | Yes | Kebab-case short description for filename (e.g. 'useCopilotChat-undefined-messages') | |
| prevention | No | How to avoid this in the future | |
| versionsAffected | No | Version range (e.g. '1.50.0 – 1.52.1') |