# 🚀 Welcome to Taskr - Your AI's Project Manager

## 1.1 What's Taskr All About?

### The Simple Version

You know how when you ask AI to help with a big project, it sometimes forgets what it was doing? Or gets confused halfway through? **Taskr fixes that.**

Think of Taskr as a **smart to-do list that your AI assistant can read and update automatically**. It's like giving your AI a perfect memory and a project manager's brain.

### What Makes Taskr Special?

Here's what Taskr does that regular AI can't:

**🧠 Never Forgets Context**
- Your AI remembers everything about your project, even after you close your computer and come back days later
- It knows exactly where it left off and what to do next
- No more "wait, what were we working on again?"

**📋 Smart Task Management**
- Breaks big projects into bite-sized pieces automatically
- Knows which tasks depend on others
- Works through them in the right order (no jumping around randomly)

**👥 Team-Friendly**
- Multiple AI agents can work on the same project without stepping on each other's toes
- Each agent knows who's doing what
- Perfect for when you want one agent coding while another handles research or planning

**📝 Keeps Perfect Notes**
- Documents everything it does automatically
- You can see what files were changed, what decisions were made, and why
- Great for understanding what your AI actually built

### How It Actually Works (The Technical Stuff, Explained Simply)

**The Big Picture:** Taskr is like a bridge between you and your AI that keeps everything organized.

Here's the flow:

1. **Your AI (Cursor, Claude Desktop, OpenClaw, etc.) connects to Taskr** through a quick one-time setup
2. **You tell your AI what you want to do** (like "I want an app that tracks my workout routine" or "research competitors for my new product")
3. **Your AI creates a smart plan** — a cloud-based, multi-layered breakdown that lives in Taskr (not just a flat to-do list)
4. **As it works, it updates Taskr** with what it's done and what it learned
5. **You can watch the progress** in real-time through the Taskr extension or website

The magic happens through something called **MCP (Model Context Protocol)**—but don't worry about the name. Just know it's the technology that lets your AI talk to Taskr automatically, kind of like how your phone apps talk to the internet.

### The Tools Your AI Gets (12 Superpowers)

When connected to Taskr, your AI gets 12 special abilities it didn't have before:

**For Managing Work:**
- Create new tasks when it discovers something needs doing
- Update tasks as it completes them
- Delete tasks that aren't needed anymore
- Get the next task automatically (no more asking "what's next?")
- View the entire project structure at once
- Sync completed work retroactively (catch up on anything it forgot to track)

**For Keeping Notes:**
- Write down what it's working on
- Update notes as things change
- Remove notes that are outdated
- Browse through all project documentation
- Read specific notes when needed
- Search through everything it's written

These tools mean your AI can manage itself—you just tell it what to build, and it handles the rest!

### Key Concepts (Things You'll See)

Before we dive in, here are the main things you'll encounter:

**Projects** 📁
- Think of these like folders for different things you're building
- Each project is completely separate (your recipe app won't mix with your workout tracker)
- You get a unique ID for each project (looks like: `PR_01JGYV...` - 26 characters after PR_)

**Tasks** ✅
- Individual things that need to be done
- Organized like an outline (1.0, 1.1, 1.2, 2.0, etc.)
- Each has a type: setup (preparing), analysis (researching), implementation (building), validation (checking), or testing
- Status shows if it's waiting, being worked on, done, or skipped

**Notes** 📝
- Documentation your AI writes as it works
- Different types for different info:
  - **FILE_LIST** - What files were created or changed
  - **PROGRESS** - Major milestones achieved
  - **CONTEXT** - Background info and decisions made
  - **FINDING** - Problems discovered and how they were fixed
  - **OTHER** - Everything else

**Guidance** 🎯
- Smart hints that Taskr gives your AI to keep it on track
- Changes based on what the AI is doing
- Prevents your AI from getting confused or going off-track

---