Streak

Quick Start

Data Storage

.streak/

.streak/
├── config.md                     # Global settings
├── active.md                     # Current challenge pointer
└── challenges/
    └── [challenge-id]/
        ├── challenge-config.md   # Metadata, goal, progress
        ├── challenge-log.md      # Progress log with summary
        ├── today.md              # Today's session context
        ├── backlog.md            # Ideas to try
        ├── preferences.md        # Type-adaptive setup
        ├── context.md            # Linked resources
        ├── insights.md           # Auto-generated insights
        └── sessions/
            └── session-XXX/
                └── notes.md      # Session notes

references/file-templates.md

Challenge Types

references/types.md

Flow 1: New Challenge

1. Initialize

   .streak/

   folder if needed
2. Ask type: Learning, Building, Fitness, Creative, Habit, or Custom
3. Basic info: Name, goal, cadence (daily/every N days/weekly)
4. Type-specific questions: See

   references/types.md

5. Create files: All templates pre-filled based on answers
6. Set active and confirm

references/flows-detailed.md

Flow 2: Check-in

Pre-Session Mode

1. Load context: Read active challenge, config, today.md, preferences, backlog
2. Show status: Session #, streak, days since last, on-track/due/overdue
3. Quick context: Energy/time, specific focus or "surprise me", constraints
4. Optional research: For Building/Learning types
5. Ideation: Type-adaptive suggestions based on energy and backlog
6. Prepare session: Create session folder and notes template

Post-Session Mode (user says "done")

1. Wrap-up questions: What worked on, how it went, what's next, key learning
2. Type-specific questions: See

   references/types.md

3. Save: Update session notes, challenge-config, challenge-log, backlog
4. Generate insights: Patterns, streaks, cross-challenge connections
5. Check achievements: See

   references/achievements.md

6. Completion message: Progress summary, achievements earned, insights

references/flows-detailed.md

Flow 3: List Challenges

--all

1. Priority (higher number first, default 0)
2. Last check-in (most recent first)

## Active Challenges
| | Name | Type | Pri | Streak | Last Check-in | Sessions |
|---|------|------|-----|--------|---------------|----------|
| * | python-courses | Learning | 10 | 5 days | 1 day ago | 3 |
|   | home-fitness | Fitness | 5 | 2 days | 2 days ago | 8 |

## Paused Challenges
|   | stories-to-novels | Writing | 0 | - | 10 days ago | 5 |

(2 archived challenges hidden - use --all to show)

* = Active challenge
Pri = Priority (edit in challenge-config.md)

--all

## Archived Challenges
|   | old-project | Building | 0 | - | 2 months ago | 20 |

Flow 4: Switch Challenge

1. Validate challenge exists
2. Update

   active.md

3. Load new challenge context
4. Confirm with status

Flow 5: Statistics

• Progress: Sessions, days since start, completion rate
• Streaks: Current, longest, average gap
• Patterns: Best day, best time, average length
• Achievements: Earned badges with dates
• Backlog: Completed, in-progress, pending items

Flow 6: Cross-Challenge Insights

1. Compound Learning: Skills from one challenge enabling another
2. Skill Transfer: Same concepts across challenges
3. Cross-Domain: Correlations between different types
4. Patterns: Best days, productivity trends
5. Suggestions: Personalized recommendations

references/achievements.md

Flow 7: Calendar Export

.ics

• Frequency based on cadence
• 30-day look-ahead (configurable)
• Works with Google, Apple, Outlook calendars

references/file-templates.md

Flow 8: Reset Challenge

• Archives log as

  challenge-log-archived-[date].md

• Archives sessions folder
• Resets streak counters
• Keeps preferences, context, backlog intact

Flow 9: Pause Challenge

1. Validate challenge exists and is active
2. Update

   challenge-config.md

   : set

   **Status:** paused

3. If pausing the active challenge:
   • List other active challenges
   • Prompt: "Paused [name]. Switch to another challenge?"
   • If yes, run Flow 4 (Switch)
4. Confirm: "Challenge [name] paused. Use

   /streak-resume [name]

   to reactivate."

Flow 10: Archive Challenge

1. Validate challenge exists and is not already archived
2. Update

   challenge-config.md

   : set

   **Status:** archived

3. If archiving the active challenge:
   • List other active challenges
   • Prompt: "Archived [name]. Switch to another challenge?"
   • If yes, run Flow 4 (Switch)
4. Confirm: "Challenge [name] archived. Use

   /streak-list --all

   to see archived challenges."

Flow 11: Resume Challenge

1. Validate challenge exists and is paused or archived
2. Update

   challenge-config.md

   : set

   **Status:** active

3. Ask: "Make [name] your active challenge?"
   • If yes, update

     active.md

4. Check days since last check-in:
   • If 7+ days: Award :muscle: Comeback badge
5. Confirm: "Challenge [name] is now active. Ready to check in?"

Achievements

Streak Badges

Milestone Badges

Special Badges

references/achievements.md

Error Handling

.streak/

Best Practices

1. Be specific in goals - "Complete Rustlings" > "Learn Rust"
2. Start sustainable - Every 2-3 days is easier than daily
3. Use today.md - Set context before sessions
4. Maintain backlog - Ideas for low-energy days
5. Review insights - Check weekly to see patterns
6. Celebrate streaks - Achievements are real motivation
7. Reset guilt-free - Archiving is progress, not failure
8. Cross-pollinate - Run multiple challenges to find connections

Reference Files

references/file-templates.md

references/types.md

references/flows-detailed.md

references/achievements.md

Examples

30 Days of AI/ML (Building)

Type: Building
Goal: Ship one AI-powered micro-app per day
Cadence: Daily
Stack: Python, TypeScript, Claude Code

Learn Rust (Learning)

Type: Learning
Goal: Complete Rustlings and build a CLI tool
Cadence: Every 2 days
Resources: Rustlings, The Rust Book

Morning Workout (Fitness)

Type: Fitness
Goal: Build consistent strength training habit
Cadence: Daily (with rest days)
Equipment: Home gym - dumbbells, pull-up bar

Daily Sketching (Creative)

Type: Creative
Goal: Draw one sketch per day for 100 days
Cadence: Daily
Medium: Digital art (Procreate)

Morning Meditation (Habit)

Type: Habit
Goal: Meditate 10 minutes every morning
Cadence: Daily
Trigger: After coffee, before email