Record Decision
cph_decision_recordRecord architectural, design, or process decisions to preserve institutional memory and explain why choices were made, including context, rationale, and alternatives.
Instructions
Record an architectural, design, or process decision.
This is the institutional memory of the project. Future sessions — and future engineers — will use this to understand why things are built the way they are.
Record a decision when:
You chose between two or more approaches
You made an assumption about requirements
The word "because" appears in your reasoning
You're doing something non-obvious that someone will question later
The post-commit hook will automatically attach the commit hash to recent decisions — you don't need to provide it manually.
Args:
workflow_id, title, decision: Required
context: What problem were you solving? What constraints existed?
rationale: Why this option over the alternatives?
alternatives_considered: Structured list of options evaluated and why rejected
trade_offs: What does this choice cost or foreclose?
tags: Comma-separated (e.g. "auth,database,performance") or array
reversibility: How hard is it to undo? (reversible | costly | irreversible)
confidence: How confident are you? (low | medium | high)
files_affected: Which files does this decision impact?
forcing_constraint: What external force required this decision now?
revisit_if: Under what conditions should this be revisited?
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workflow_id | Yes | ||
| title | Yes | ||
| decision | Yes | The actual choice made | |
| context | No | ||
| rationale | No | ||
| alternatives_considered | No | Structured alternatives: [{option, rejected_because}] | |
| trade_offs | No | ||
| task_id | No | ||
| tags | No | Comma-separated tags or array | |
| forcing_constraint | No | What external force required this decision now? | |
| unlocks | No | What does this decision enable? | |
| constrains | No | What does this decision prevent or limit? | |
| revisit_if | No | Under what conditions should this be revisited? | |
| blocker_id | No | Blocker this decision resolves | |
| files_affected | No | File paths affected by this decision | |
| reversibility | No | How hard to undo? | |
| confidence | No | Decision confidence level |