# 🎯 How Taskr Actually Works

## 3.2 Task Lists - Keeping Features Organized

### The Mental Model

Imagine you're organizing a big party:
- **"Food & Drinks"** task list - Buy ingredients, prep food, set up bar
- **"Decorations"** task list - Hang lights, arrange flowers, set tables
- **"Entertainment"** task list - Create playlist, set up games, test speakers

Each list is independent. You can work on decorations without thinking about food. That's exactly how task lists work in Taskr!

### Why Task Lists Are Brilliant

**Without task lists:** Everything would be one giant mess of tasks
**With task lists:** Each feature/component stays organized in its own space

Your AI agent naturally stays focused because it works on one task list at a time. When working on "User Authentication," it won't suddenly jump to "Payment Processing."

### How They're Created

Task lists appear automatically when your AI creates tasks:

1. **When you ask your AI to plan a feature** - "Generate tasks for adding user profiles"
2. **When your AI creates a batch of tasks** - It organizes them into logical lists
3. **When your AI breaks down work** - Related tasks get grouped into feature-based lists

### How It Works Under the Hood

Task lists aren't a separate thing—they're actually the **top-level tasks** in your project. When your AI creates a task list called "User Authentication," it's really creating a root task with a special `TL_` prefix ID. All the subtasks underneath it use `TS_` prefix IDs.

This unified design means task lists and tasks share the same hierarchy—a task list is just a task that happens to be at the top level. Your AI's `get_task` function filters by task list to stay focused on one feature at a time.

---