Skip to content

Add Reminders System and Decision Log System features#4

Merged
Kiyoraka merged 1 commit intoKiyoraka:mainfrom
faizkhairi:feature/reminders-and-decision-log
Mar 21, 2026
Merged

Add Reminders System and Decision Log System features#4
Kiyoraka merged 1 commit intoKiyoraka:mainfrom
faizkhairi:feature/reminders-and-decision-log

Conversation

@faizkhairi
Copy link
Copy Markdown
Contributor

Summary

Two new feature extensions based on 4+ months of daily production use with an AI companion system. Both solve the same core problem: important context gets lost when session memory resets.

Reminders System (Feature/Reminders-System/)

Persistent cross-session reminders that survive memory resets.

  • reminders.md file with Open/Completed lifecycle
  • Deadline tracking with overdue detection at session start
  • Natural language triggers: "remind me", "don't forget", "follow up", "by [date]"
  • Session integration: AI reads reminders at start, updates at end
  • Includes README, install protocol, and SKILL.md for auto-triggering

The key design insight: session memory (current-session.md) resets every session. Reminders must live in a separate file that persists independently.

Decision Log System (Feature/Decision-Log-System/)

Append-only record of non-obvious architectural and technical decisions.

  • Context + Decision + Rationale format per entry
  • Immutable history: past decisions are never edited; reversals create new entries
  • Searchable via "why did we choose X?"
  • AI detects decision-worthy moments naturally
  • Includes README and install protocol

The key constraint: append-only. Editing past decisions rewrites history. If you reverse a decision, log a NEW entry explaining why.

README Updates

  • File structure updated with both new features
  • Feature description sections with quick setup, benefits, and commands
  • Version bumped to 3.1

Files added (5 new, 1 modified)

  • Feature/Reminders-System/README.md -- feature explanation
  • Feature/Reminders-System/install-reminders.md -- 4-step install protocol
  • Feature/Reminders-System/SKILL.md -- auto-triggered skill
  • Feature/Decision-Log-System/README.md -- feature explanation
  • Feature/Decision-Log-System/install-decision-log.md -- 3-step install protocol
  • README.md -- updated file structure + feature descriptions

Design Decisions

Both features follow existing project conventions:

  • Each feature has README.md + install protocol (+ optional SKILL.md)
  • Install protocols use the same step-by-step checkbox format
  • Feature descriptions in README match the style of existing entries
  • Both integrate with master-memory.md and identity-core.md during installation

Synergy with Existing Features

New Feature Works With How
Reminders Save Diary Diary captures what happened; reminders track what's next
Reminders Echo Recall "Do you remember that reminder about X?"
Decision Log Echo Recall "Why did we choose X?" searches the decision log
Decision Log Auto-Commit Decision entries can trigger a commit
Reminders Decision Log "Revisit this decision in 2 weeks" becomes a reminder

Two new feature extensions based on production AI companion experience:

Reminders System (Feature/Reminders-System/):
- Persistent cross-session reminders with Open/Completed lifecycle
- Deadline tracking with overdue detection at session start
- Natural language triggers ("remind me", "follow up", "don't forget")
- Independent from session RAM -- survives memory resets
- Includes README, install protocol, and SKILL.md for auto-triggering

Decision Log System (Feature/Decision-Log-System/):
- Append-only record of non-obvious decisions
- Context + Decision + Rationale format per entry
- Immutable history -- reversals create new entries, never edit old ones
- Searchable via "why did we choose X?"
- Includes README and install protocol

README updated with:
- File structure listing for both new features
- Feature description sections with quick setup, benefits, and commands
- Version bumped to 3.1
@Kiyoraka Kiyoraka merged commit 57ef3f9 into Kiyoraka:main Mar 21, 2026
Kiyoraka added a commit that referenced this pull request Mar 27, 2026
=== TECHNICAL CHANGES ===
• Feature/Decision-Log-System/SKILL.md: Create missing auto-trigger skill for Decision Log System - matches Reminders System SKILL.md pattern with detection, logging, search, and reversal protocols
• README.md: Fix version tag to include Library System (was overwritten by PR #4), add Faiz Khairi as contributor, update last modified date

=== SESSION CONTEXT ===
• Project: AI MemoryCore | Type: maintenance/review | Time: 12 min
• Emotional Depth: MEDIUM - Code review and quality repair session
• Leadership: Kiyo reviewed PRs and identified issues | Alice: analyzed contributions, created missing skill, repaired metadata
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants