/streak

name: streak
description: Universal challenge tracker with flexible cadence, intelligent insights, and cross-challenge learning detection. Use when user wants to track any personal challenge - learning, habits, building, fitness, creative, or custom. Supports daily, weekly, or N-day check-ins with type-adaptive preferences, backlog, and context files.

Streak

A universal, flexible challenge tracking system for Claude Code. Track any personal challenge with intelligent insights and cross-challenge learning detection.

**Works for any challenge type:** Learning, Building, Fitness, Creative, Habit, or Custom.

---

Quick Start

**Trigger phrases -> Flows:**

| User Says | Flow | |-----------|------| | "new challenge", "start a streak", "track a goal" | Flow 1: New Challenge | | "check in", "log progress", "update my streak" | Flow 2: Check-in | | "list challenges", "show all challenges" | Flow 3: List | | "switch to [name]", "change challenge" | Flow 4: Switch | | "show stats", "my progress" | Flow 5: Statistics | | "show insights", "cross-challenge" | Flow 6: Insights | | "export calendar", "create reminders" | Flow 7: Calendar | | "reset challenge", "start fresh" | Flow 8: Reset | | "pause [name]", "put on hold" | Flow 9: Pause | | "archive [name]", "shelve challenge" | Flow 10: Archive | | "resume [name]", "reactivate" | Flow 11: Resume | | "setup notifications", "telegram reminders" | Flow 12: Notifications | | "setup telegram bot", "deploy telegram", "streak-telegram" | Flow 13: Telegram Bot Deploy |

---

Data Storage

All data in `.streak/` folder:

.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

**File templates:** See `references/file-templates.md`

---

Challenge Types

| Type | Best For | Key Questions | |------|----------|---------------| | **Learning** | Courses, books, skills | "Any aha moments?", "Progress on milestones?" | | **Building** | Projects, shipping | "What did you ship?", "Any blockers?" | | **Fitness** | Workouts, health | "What exercises?", "How did body feel?" | | **Creative** | Art, writing, music | "What did you create?", "Any inspiration?" | | **Habit** | Routines, consistency | "Did you complete it?", "How did it feel?" | | **Custom** | Anything else | User-defined questions |

**Type details:** See `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

**Detailed steps:** See `references/flows-detailed.md`

---

Flow 2: Check-in

Two modes: **Pre-session** (planning) and **Post-session** (wrap-up)

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

**Shortcuts during flow:**

| Say | Action | |-----|--------| | "Just research" | Only research step | | "Skip to suggestions" | Skip research | | "I know what I'm doing: [idea]" | Skip ideation | | "Done" / "Finished" / "Back" | Jump to wrap-up | | "Quick check-in" | Minimal logging |

**Detailed steps:** See `references/flows-detailed.md`

---

Flow 3: List Challenges

Display challenges grouped by status, sorted by priority then recency.

**Default:** Show active + paused challenges **With `--all` flag:** Include archived challenges

**Sorting order (within each group):** 1. Priority (higher number first, default 0) 2. Last check-in (most recent first)

**Display format:**

## 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)

**With `--all` flag, also show:**

## 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

Show for active challenge:

• **Progress:** Sessions, days since start, completion rate
• **Streaks:** Current, longest, average gap
• **Patterns:** Best day, be