kiyoraka/project-ai-memorycore/decision-log-system

Log Decision -- Append-Only Decision Tracking Skill

Every important "why" captured, every trade-off remembered.

Activation

When this skill activates, silently read main/decisions.md.

• If user is logging a decision: capture and confirm
• If user is searching past decisions: find and present
• If a decision-worthy moment is detected: offer to log it

Context Guard

Protocol

On Decision Detection

• [ ] Identify the decision: what was chosen and what was rejected
• [ ] Determine if it's non-obvious (skip trivial/obvious choices)
• [ ] If non-obvious: offer to log it or log automatically if user said "log decision"

On Logging a Decision

• [ ] Get current date (YYYY-MM-DD)
• [ ] Write a short descriptive title
• [ ] Compose entry in format:

``markdown ## YYYY-MM-DD -- Short title **Context**: What situation prompted this decision **Decision**: What was chosen (and what was rejected) **Rationale**: Why -- trade-offs, constraints, evidence ``

• [ ] APPEND to main/decisions.md (after the last entry)
• [ ] Confirm: "Logged decision: [title]"

On Searching Decisions

• [ ] Read main/decisions.md
• [ ] Search for keywords matching the user's query
• [ ] Present matching decision(s) with full context
• [ ] If no match: inform user and offer to log a new entry

On Reversing a Decision

• [ ] DO NOT edit the original entry
• [ ] APPEND a new entry referencing the original:

``markdown ## YYYY-MM-DD -- Reversed: [original title] **Context**: Why the original decision is being reconsidered **Decision**: New choice, referencing the old one **Rationale**: What changed -- new information, constraints, or priorities ``

Mandatory Rules

1. Append-only -- NEVER edit or delete past entries
2. Context + Decision + Rationale -- all three fields required for every entry
3. Include rejected alternatives -- document what was NOT chosen and why
4. Non-obvious only -- skip trivial choices (using git, formatting preferences)
5. Natural detection -- detect decision-worthy moments without requiring explicit commands

Edge Cases

Level History

• Lv.1 -- Base: decision detection, append-only logging, Context+Decision+Rationale format, search, reversal tracking.