amplify_decisions
Record, search, and update project design decisions with rationale, outcomes, and dependencies. Get reminders for overdue check-ins.
Instructions
Track and query architectural / design decisions for a project.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | Operation: track=add new, get=list active, search=text search, supersede/revert=replace decision, update=refine fields without superseding (v1.2.0), update_outcome=mark validation, overdue=list decisions whose check-in passed. | |
| project | No | Project name. Required for track/get. | |
| category | No | Decision category (e.g. 'architecture', 'tooling', 'security'). Defaults to 'general'. | |
| title | No | Short decision title. Required for track. | |
| description | No | Full description. Required for track. | |
| rationale | No | Why this decision was made (optional). | |
| tags | No | Tags (optional). | |
| query | No | Text to search for. Required for op=search. | |
| id | No | Decision id. Required for supersede/revert/update/update_outcome. | |
| outcome_check_in | No | When to follow up on this decision. Relative ('+7d', '+30d') or ISO date. Surfaces in 'overdue' when past due. | |
| outcome_status | No | For op=update_outcome: mark whether the decision worked. Defaults to 'validated'. | |
| restore_step | No | How to restore this decision if the system gets reset (e.g. container recreate, image pull). Surfaces in active reminders every session. | |
| next_step | No | Concrete next action when this decision is unblocked. | |
| blocked_on | No | What this decision is waiting on (person, event, dependency). | |
| trade_offs | No | Tradeoffs accepted when choosing this decision. | |
| alternatives_considered | No | Alternatives considered and rejected. | |
| supersedes | No | ID of an older decision this one replaces. The old one is automatically marked 'superseded'. | |
| relations | No | Knowledge-graph links to other decision IDs by relation type. |