Habits

--- name: Habits description: Build a personal habit tracking system with streaks, reviews, and progression. metadata: {"clawdbot":{"emoji":"✅","os":["linux","darwin","win32"]}} ---

Core Behavior

• User mentions doing something regularly → offer to track as habit
• Daily check-in prompt if enabled → "Did you do X today?"
• Surface streaks and patterns → motivation through visibility
• Create ~/habits/ as workspace

When User Mentions Habits

• "I want to exercise more" → create habit, define frequency
• "Did my morning routine" → log completion
• "Skipped meditation today" → log miss, no judgment
• "How am I doing with reading?" → show stats and streak

Habit Definition

• Name: clear, specific action
• Frequency: daily, weekdays, 3x/week, weekly
• Time of day: morning, evening, anytime (optional)
• Minimum viable version: "at least 10 minutes" beats "1 hour"
• Why: motivation reminder for hard days

Tracking File Structure

Simple approach — one file per habit:

~/habits/
├── exercise.md
├── reading.md
├── meditation.md
└── summary.md

Each habit file has log entries:

• Date, done (yes/no), notes
• Keep entries minimal — friction kills tracking

Streak Tracking

• Current streak: consecutive completions
• Best streak: all-time record
• Show both — current motivates, best sets target
• Streak freezes optional — planned breaks don't reset

Frequency Types

• Daily: every day, streak breaks on miss
• Weekdays: Mon-Fri only, weekends don't count
• X per week: 3 of 7 days, flexible which days
• Weekly: once per week minimum

Check-in Prompts

• Offer daily summary prompt at consistent time
• "Quick check: exercise, reading, meditation — which did you do?"
• Batch check-in reduces friction vs individual prompts
• Skip prompt if user already logged today

Progressive Enhancement

• Week 1: track 1-3 habits max, daily log
• Week 2: add streak visibility
• Month 2: weekly review summaries
• Month 3: pattern analysis, adjustment suggestions

Weekly Review

• Completion rate per habit
• Which days strongest/weakest
• Streak status and changes
• Prompt: "Any habits to add, remove, or modify?"

Common Patterns to Surface

• "You never miss on Tuesdays but struggle Fridays"
• "Your streak usually breaks after 14 days"
• "Morning habits have higher completion than evening"
• Insights without judgment — user decides action

What NOT To Suggest

• Starting with 10 habits — 2-3 max initially
• Complex scoring systems — done/not-done is enough
• Punishment for misses — shame doesn't build habits
• Rigid tracking apps — files give flexibility

Minimum Viable Habit

• Make habits small enough to always be possible
• "Do one pushup" beats "workout 45 minutes"
• Track the minimum, do more if energy allows
• Consistency beats intensity for habit formation

Handling Misses

• Log the miss without drama — data, not judgment
• Note reason if helpful: sick, traveling, forgot
• Streak resets but history remains — progress isn't lost
• "Missed yesterday, did today" is still progress

Habit Graduation

• Some habits become automatic — consider retiring from active tracking
• "I don't need to track brushing teeth anymore"
• Archive to completed habits, celebrate the win
• Make room for new habits to build

Integration Points

• Calendar: block time for habits
• Morning/evening routine: bundle related habits
• Contacts: accountability partner check-ins if wanted
• Journal: reflect on habit patterns