record_decision
Records or updates an Architectural Decision Record so technical rules and conventions persist across agents, preventing decision drift.
Instructions
Records or updates an Architectural Decision Record (ADR) in Tier 2.
Call this tool whenever you establish a technical rule, make an architectural choice, or change an existing convention. Prevents decision drift and ensures subsequent agents (Claude, Codex, Antigravity) follow the agreed specification.
Lifecycle:
'accepted': Active binding decision (automatically visible on Tier 1 State Card).
'proposed': Under review or draft; not yet binding.
'superseded': Replaced by a newer ADR; archived in Tier 2 history.
'rejected': Proposed but explicitly abandoned with reason in rationale.
Formatting Rule: Preserve exact technical tokens in 'rationale' (e.g. file paths, PRAGMA flags, error codes, function signatures). Avoid fuzzy narrative paraphrasing.
Args: decision_id: Unique identifier string (e.g., 'ADR-001', 'ADR-STORAGE-WAL'). title: Short, descriptive title of the decision. rationale: Verbatim technical justification, constraints, and parameters. decided_by: Name or identity of the decider (e.g., 'claude', 'codex', 'human'). status: Decision status ('accepted', 'proposed', 'superseded', 'rejected').
Returns: str: Confirmation message with the recorded decision ID and status.
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": {
"decision_id": "<decision_id>",
"title": "<title>",
"rationale": "<rationale>"
},
"name": "record_decision"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| status | No | accepted | |
| rationale | Yes | ||
| decided_by | No | agent | |
| decision_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |