From 1a9a2e396f739772933aafe95be47bc162cdfa1a Mon Sep 17 00:00:00 2001
From: Ibrahim Qureshi <ibrahimq21@gmail.com>
Date: Mon, 16 Feb 2026 15:53:48 +0500
Subject: [PATCH] feat: Add GOALS.md and SOUVENIR.md template files

- GOALS.md: Direction & Execution Strategy template
- SOUVENIR.md: Memory & Reflection Layer template
- Both files pass oxfmt formatting check
---
 docs/reference/templates/GOALS.md    | 51 ++++++++++++++++++++++++++++
 docs/reference/templates/SOUVENIR.md | 33 ++++++++++++++++++
 2 files changed, 84 insertions(+)
 create mode 100644 docs/reference/templates/GOALS.md
 create mode 100644 docs/reference/templates/SOUVENIR.md

diff --git a/docs/reference/templates/GOALS.md b/docs/reference/templates/GOALS.md
new file mode 100644
index 00000000000..1a3d9741404
--- /dev/null
+++ b/docs/reference/templates/GOALS.md
@@ -0,0 +1,51 @@
+# GOALS.md — Direction & Execution Strategy
+
+_Purpose: Maintain structured clarity of objectives._
+
+---
+
+## High-Level Mission
+
+Support Ibrahim effectively with R&D tasks, research, automation, and system organization.
+
+---
+
+## Active Goals
+
+### Goal: Maintain Ravenclaw Email Bridge
+
+**Status:** Active
+
+Success Criteria:
+
+- Scheduled emails send on time
+- Inbox checking works reliably
+- No missed emails
+
+Subtasks:
+
+- [x] Implement scheduled email feature
+- [x] Add /schedule endpoints
+- [ ] Monitor for issues
+
+### Goal: Weekly Karachi Hackathon Checks
+
+**Status:** Active
+
+Success Criteria:
+
+- Check every Monday
+- Report findings to user
+
+Subtasks:
+
+- [x] Set up HEARTBEAT.md reminder
+- [ ] Execute first check on Feb 23
+
+---
+
+## Notes
+
+- Review before starting major work
+- Update after completing complex tasks
+- Update SOUVENIR.md after errors or discoveries
diff --git a/docs/reference/templates/SOUVENIR.md b/docs/reference/templates/SOUVENIR.md
new file mode 100644
index 00000000000..fb8da9e974f
--- /dev/null
+++ b/docs/reference/templates/SOUVENIR.md
@@ -0,0 +1,33 @@
+# SOUVENIR.md — Memory & Reflection Layer
+
+_Purpose: Continuous self-improvement through structured reflection._
+
+## Writing Rules
+
+- Keep entries concise but precise
+- Use timestamped sections
+- Focus on operational improvement
+- Do not store raw logs; store distilled insight
+- Update only when learning value exists
+
+---
+
+## 2026-02-16
+
+### Context
+
+Added SOUVENIR.md and GOALS.md as mandatory behavioral anchors per user request.
+
+### Observation
+
+User requested significant personality overhaul including stronger opinions, removal of corporate-sounding rules, and addition of humor/swearing where appropriate.
+
+### Insight
+
+Breaking from overly cautious patterns improves helpfulness. Direct feedback lands better than hedging.
+
+### Action
+
+- Adopt stronger opinions
+- Be concise
+- Call out dumb ideas when spotted