decision-record

Records user-approved decisions and unresolved discussion points via add_decisions in CALM.

3|1|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/isizono/calm --skill decision-record-isizono
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: decision-record
Source: https://github.com/isizono/calm/tree/main/skills/decision-record
Command: npx skills add https://github.com/isizono/calm --skill decision-record-isizono

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? In long-running Claude Code projects, agreements reached with the user and open questions left unresolved are lost between sessions. This Skill ensures every confirmed decision and pending discussion point is captured in the CALM SQLite memory database with proper judgment criteria, so context carries over to future sessions. ## Core Features & Use Cases - Agreement Detection: Triggers only on explicit user approval ("OK", "let's go with that", "decided on X") and records the decision with title, topic, tags, and reason via add_decisions. - Unresolved Point Tracking: Records open discussion points with a [議論中] prefix when topics shift or sessions near their end, without requiring consensus. - Precedent Sections: Supports optional structured sections (rejected alternatives, scope in/out, verification, adjacent checks) parsed into machine-readable precedent fields, with soft validation warnings for format drift. - Use Case: During a design discussion the user approves one of three proposed architectures. The Skill records the chosen approach as a decision with its rationale and rejected alternatives, while the comparison process itself is logged separately by the recording skill. ## Quick Start When the user explicitly approves a proposal during the session, invoke this Skill to record the decision with add_decisions including title, topic_id, domain tags, and reason.

Frequently Asked Questions about decision-record

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record decisions made during a Claude Code session?▼

Use this Skill, which guides the add_decisions call whenever the user explicitly approves a proposal. It requires a topic_id, domain tags, and a reason field separating the conclusion from its rationale, and strongly recommends a title for list readability.

When should a decision be recorded versus a discussion log?▼

Record a decision only when explicit user agreement exists, such as approval phrases or a declared choice. Discussion process and outcomes without consensus belong to the recording skill via add_logs, while unresolved points use the [議論中] prefix in add_decisions.

How do I record unresolved discussion points without consensus?▼

Prefix the decision body with [議論中] and list the candidate options and how far the discussion progressed in the reason field. Trigger this when the topic shifts or the session nears its end; no user agreement is required for these state records.

What are precedent sections in decision reasons?▼

Precedent sections are optional structured blocks at the end of a reason: rejected alternatives, scope in/out, verification, and adjacent checks. They are parsed into a machine-readable precedent field returned by add_decisions and reflected in get_decisions responses.

Why does add_decisions return precedent_warnings?▼

Warnings appear when section formatting deviates from the spec, such as missing colons, non-line-start headings, or near-miss headings like 却下例 instead of 却下案. They are soft validation only; the decision is still created and the warning guides future format fixes.

What happens when a new decision contradicts an existing one?▼

The add_decisions response includes related_decisions showing similar entries in the same topic. If a contradiction or duplicate is noticed, report it immediately with report_signal(kind="contradiction"); retract or supersede decisions are outside this Skill's scope.