App — Tasks
Individual tasks + the Top Tasks daily routine. Lightweight task management built for actually getting done.
| Field | Value |
|---|---|
| Status | GA |
| Owner | @aphaiboon |
| Sidekick-accessible | Read + write |
What it is
Section titled “What it is”Two surfaces:
- Task list — all of your tasks, filterable by status, priority, due date, project, team
- Top Tasks — daily ritual: pick 3-5 tasks to focus on today. Tracked as a session.
Tasks can be linked to Projects, Brain docs, Calendar events, Comms threads.
Status & priority
Section titled “Status & priority”Constants in @shared/constants/task-constants — TaskStatus (todo / in_progress / blocked / done / archived) and TaskPriority (p0 / p1 / p2 / p3). NEVER inline strings.
Top Tasks daily routine
Section titled “Top Tasks daily routine”The “what matters today” experience:
- Sidekick suggests 3-5 tasks (based on due date, priority, recently active threads)
- User confirms / edits
- Top Tasks session opens — only those tasks visible in the Top Tasks surface (rendered on Dashboard)
- As tasks complete, completion is logged
- End-of-day: completion rate fed back into next day’s suggestions
top_tasks_sessions table tracks this. Completion rate is a North Star metric.
Quick-add (platform standard)
Section titled “Quick-add (platform standard)”All list-type apps including Tasks MUST provide an <InlineAdd> row at the top — NOT a modal triggered from header. Empty-state copy: “No tasks yet. Type above to add your first one.”
Sidekick integration
Section titled “Sidekick integration”| Capability | Tool |
|---|---|
| Create task | create_task |
| Update task | update_task |
| Complete task | complete_task |
| Query tasks (filters) | query_tasks |
| Suggest top tasks for today | suggest_top_tasks |
Data model
Section titled “Data model”| Table | Purpose |
|---|---|
tasks | Task rows — title, status, priority, dueDate, organizationId, projectId, threadId |
top_tasks_sessions | Daily Top Tasks selections + completion |
Related incidents
Section titled “Related incidents”- FM-045 — Cross-workspace personal surfaces hit requireAppEnabled 403s (Tasks was the trigger)
- FM-047 — Temporary diagnostic route exposed task data
Related
Section titled “Related”- App — Projects — Tasks roll up to Projects
- App — Strategy & Goals — Top Tasks feed into goal progress
- App — Dashboard — Top Tasks rendered on the home screen
- App — Calendar — tasks with due dates appear on calendar
- App — Sidekick — primary writer of new tasks
- Data Access — Repository Pattern