openspec_record_revision
Log design revisions for bug fixes or design adjustments that deviate from the original proposal, capturing change type and affected components.
Instructions
Record a design revision when fixing bugs or adjusting design that deviates from the original proposal/design. Call this when your changes affect the documented design.
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": {
"changeId": "<changeId>",
"description": "<description>"
},
"name": "openspec_record_revision"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| changeId | Yes | Change ID | |
| description | Yes | Description of the design change (e.g., "Simplified approval states from 6 to 5") | |
| reason | No | Reason for the change (e.g., "UI was too complex") | |
| metadata | No | Revision metadata for tracking impact |