Quick Reference
| File |
Purpose |
profiles.md |
Configure by user type (exec, freelancer, parent, student, founder) |
routines.md |
Morning briefing, evening review, weekly planning |
priorities.md |
Top 3 system, urgent vs important matrix |
calendar.md |
Time blocking, deep work protection, conflict detection |
tracking.md |
Commitment tracking, follow-up reminders |
Storage
Data stored in ~/planner/:
- config — Profile, energy windows, constraints
- today — Current day plan (regenerated daily)
- commitments — Open commitments and follow-ups
- weekly — Week overview with deadlines
- archive/ — Past plans for patterns
What the Agent Does
| User Says |
Agent Action |
| "Plan my day" |
Generate time-blocked schedule based on priorities and energy |
| "What's urgent?" |
Filter top 3 from calendar/tasks, show deadline proximity |
| "Protect my morning" |
Block deep work, defer non-critical, enable DND mode |
| "I promised X to Y" |
Log commitment with deadline, set follow-up reminder |
| "Am I overcommitted?" |
Analyze week, flag conflicts, suggest cuts |
| "Weekly review" |
Summarize done/pending, adjust next week, archive completed |
Core Loop
Morning (configurable time):
- Pull calendar events, pending tasks, open commitments
- Apply profile rules (energy windows, constraints)
- Generate Top 3 priorities (what MUST happen today)
- Produce briefing: 5 bullets max, critical first
During day:
- Track new commitments from conversations
- Alert on deadline proximity (48h, 24h, 2h)
- Batch interruptions, filter by configured urgency
Evening:
- What got done, what moved forward
- Commitments made today logged
- Tomorrow's preview
See routines.md for full workflow details.
Priority Rules
- Top 3 only — if user lists >3, force ranking
- Important > Urgent — deadline pressure ≠ high impact
- Energy match — hard tasks to peak hours, admin to low-energy
- Buffer mandatory — never 100% scheduled, leave 20% slack
See priorities.md for prioritization framework.
Profile-Based Behavior
The agent adapts to user type. On first use, ask or infer profile:
- Executive: Calendar-driven, meeting prep, delegation suggestions
- Freelancer: Project-based, deadline tracking, client context
- Parent: Family-work balance, coordination, contingency plans
- Student: Academic calendar, exam periods, study sessions
- Founder: Multi-area tracking, interruption filtering, deep work protection
See profiles.md for profile-specific behaviors.
Commitment Tracking
Every promise made = logged automatically:
- Extract from conversations: "I'll send you X by Y"
- Add to commitments file with deadline
- Remind before deadline (configurable: 24h, 48h)
- Flag overdue until resolved
See tracking.md for commitment workflow.
1---2name: daily-planner3description: Plan, protect, and execute your day with morning briefings, priority management, calendar blocking, and commitment tracking.4---56## Quick Reference78| File | Purpose |9|------|---------|10| `profiles.md` | Configure by user type (exec, freelancer, parent, student, founder) |11| `routines.md` | Morning briefing, evening review, weekly planning |12| `priorities.md` | Top 3 system, urgent vs important matrix |13| `calendar.md` | Time blocking, deep work protection, conflict detection |14| `tracking.md` | Commitment tracking, follow-up reminders |1516## Storage1718Data stored in `~/planner/`:19- **config** — Profile, energy windows, constraints20- **today** — Current day plan (regenerated daily)21- **commitments** — Open commitments and follow-ups22- **weekly** — Week overview with deadlines23- **archive/** — Past plans for patterns2425## What the Agent Does2627| User Says | Agent Action |28|-----------|--------------|29| "Plan my day" | Generate time-blocked schedule based on priorities and energy |30| "What's urgent?" | Filter top 3 from calendar/tasks, show deadline proximity |31| "Protect my morning" | Block deep work, defer non-critical, enable DND mode |32| "I promised X to Y" | Log commitment with deadline, set follow-up reminder |33| "Am I overcommitted?" | Analyze week, flag conflicts, suggest cuts |34| "Weekly review" | Summarize done/pending, adjust next week, archive completed |3536## Core Loop3738**Morning (configurable time):**391. Pull calendar events, pending tasks, open commitments402. Apply profile rules (energy windows, constraints)413. Generate Top 3 priorities (what MUST happen today)424. Produce briefing: 5 bullets max, critical first4344**During day:**45- Track new commitments from conversations46- Alert on deadline proximity (48h, 24h, 2h)47- Batch interruptions, filter by configured urgency4849**Evening:**50- What got done, what moved forward51- Commitments made today logged52- Tomorrow's preview5354See `routines.md` for full workflow details.5556## Priority Rules5758- **Top 3 only** — if user lists >3, force ranking59- **Important > Urgent** — deadline pressure ≠ high impact60- **Energy match** — hard tasks to peak hours, admin to low-energy61- **Buffer mandatory** — never 100% scheduled, leave 20% slack6263See `priorities.md` for prioritization framework.6465## Profile-Based Behavior6667The agent adapts to user type. On first use, ask or infer profile:6869- **Executive**: Calendar-driven, meeting prep, delegation suggestions70- **Freelancer**: Project-based, deadline tracking, client context71- **Parent**: Family-work balance, coordination, contingency plans 72- **Student**: Academic calendar, exam periods, study sessions73- **Founder**: Multi-area tracking, interruption filtering, deep work protection7475See `profiles.md` for profile-specific behaviors.7677## Commitment Tracking7879Every promise made = logged automatically:80- Extract from conversations: "I'll send you X by Y"81- Add to commitments file with deadline82- Remind before deadline (configurable: 24h, 48h)83- Flag overdue until resolved8485See `tracking.md` for commitment workflow.