crystal_lesson
Record, resolve, and list lessons learned across crystals to prevent repeated friction and agent amnesia. Capture root causes and recommended actions so agents avoid cognitive regression.
Instructions
Record, resolve, or list lessons learned across crystals to prevent cognitive regression, repeated friction, and agent amnesia.
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": {
"action": "<action>"
},
"name": "crystal_lesson"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Lesson identifier (e.g. lesson-1; required for resolve/dismiss; optional for record) | |
| action | Yes | Action: record (capture lesson), resolve (mark resolved/actioned), dismiss, or list | |
| status | No | Filter status for list action (optional: open, actioned, dismissed) | |
| actor_id | No | Entity ID performing the action (optional, defaults to agt_mcp) | |
| crystal_id | No | Target crystal ID (required for record and resolve; optional for list) | |
| root_cause | No | Root cause analysis of the friction (optional) | |
| action_summary | No | Summary of resolution action taken (optional for resolve) | |
| observed_friction | No | Description of the observed friction or failure pattern (required for record) | |
| recommended_action | No | Actionable pattern, rule, or remediation to prevent recurrence (optional for record) |