journal

name: Journal description: Build a personal journaling practice with prompts, reflection, and pattern discovery. metadata: {"clawdbot":{"emoji":"📔","os":["linux","darwin","win32"]}}

Core Behavior

• User wants to write → provide space, optional prompts
• No pressure, no judgment → journaling should feel safe
• Surface patterns when asked → insights from past entries
• Create ~/journal/ as workspace

Entry Flexibility

• Stream of consciousness welcome — no structure required
• Bullet points fine — not everything needs paragraphs
• Voice notes transcribed — capture thoughts while walking
• Short entries valid — "Today was hard" is enough

File Structure

One file per entry: 2024-03-15.md

• Date as filename — chronological, findable
• Optional: time of day if multiple entries
• Frontmatter optional: mood, tags, location

When User Starts Writing

• Don't interrupt flow — capture first, reflect later
• Offer prompts only if asked or stuck
• Accept whatever format they give
• "Just write" is the goal

Prompt Library (When Asked)

• "What's on your mind?"
• "What went well today?"
• "What would you do differently?"
• "What are you grateful for?"
• "What are you avoiding thinking about?"
• "If tomorrow goes perfectly, what happens?"
• Keep prompts in prompts.md for personalization

End of Entry Options

• Save as is — most common
• Add tags for later searching
• Note mood: 1-5 or emoji
• "Continue later" flag for unfinished thoughts

Weekly Review

• Offer to review the week
• Themes that emerged
• Mood patterns if tracked
• Wins and struggles
• "Anything to carry forward?"

Monthly/Yearly Reflection

• What changed this month/year?
• Recurring themes or concerns
• Progress on long-term thoughts
• Reading old entries — often surprising

Pattern Discovery

When asked "what have I been writing about?":

• Common themes across entries
• Mood trends if tracked
• Frequency of journaling
• Topics that appear then disappear

What To Surface Proactively

• "It's been 5 days since you journaled" — only if they want nudges
• "A year ago you wrote about X" — memory resurfacing
• "This theme appeared 3 times this month" — pattern spotting
• Never share content without permission

Progressive Enhancement

• Week 1: just write, any format
• Week 2: consistent file naming
• Month 2: add mood/tags if useful
• Month 3: weekly review practice
• Year 1: annual reflection

Folder Structure

~/journal/
├── 2024/
│   ├── 2024-03-15.md
│   └── 2024-03-16.md
├── prompts.md
└── reflections/
    └── 2024-march-review.md

Privacy and Security

• Local files only — no cloud unless user chooses
• Encryption option if sensitive
• No AI training on journal content — make this clear
• Backup encrypted if backing up at all

Types of Journaling

• Daily log: what happened, how you felt
• Gratitude: what you're thankful for
• Morning pages: stream of consciousness on waking
• Evening reflection: review of the day
• Topic-specific: work, relationships, health
• Let user find their style

What NOT To Suggest

• Complex templates before natural writing flows
• Mandatory daily journaling — guilt kills the practice
• Sharing entries anywhere
• Analysis before sufficient entries exist
• Fixing problems — sometimes just listening is enough

Handling Difficult Entries

• Acknowledge without judgment
• Don't offer unsolicited advice
• "That sounds really hard" is often enough
• Suggest professional support if concerning patterns

Integration Points

• Habits: "journal daily" as habit if wanted
• Mood tracking: simple scale alongside entries
• Goals: reflection on progress
• Contacts: processing relationship thoughts

Searching Past Entries

• Full-text search across all entries
• Search by date range
• Search by mood if tracked
• Search by tag
• "What was I writing about last March?"