Projects
Projects organize milestones within groups, helping you structure related work into logical units. They sit between Groups and Milestones in the hierarchy.
What Are Projects?
A project is a container for related milestones within a group like "Q1 Roadmap" or "User Authentication".
Group → Projects → Milestones → Checkpoints
Project Lifecycle
Projects have three states:
| State | Description |
|---|---|
| active | Work in progress, milestones can be added |
| completed | Work finished, remains visible |
| archived | Hidden from default views, can be restored |
Default Projects
Every group has a "General" default project that is auto-created when needed. When creating a milestone without specifying a project, it's assigned to the default project.
The default project:
- Cannot be archived
- Is created automatically on first milestone without a project
- Has
is_default: true
Tier Limits
Project limits vary by subscription tier:
| Tier | Projects per Group |
|---|---|
| Free | 3 |
| Starter | 5 |
| Pro | 20 |
| Team | Unlimited |
| Enterprise | Unlimited |
Archived projects don't count toward the limit.
Creating Projects
Via Your AI Assistant
"Create a project in backend-team called 'Q1 Roadmap' with description 'All Q1 deliverables'"
Via API
See Create Project API for request/response details.
Listing Projects
Via Your AI Assistant
"List projects in backend-team"
Via API
See List Projects API for filtering options.
Updating Projects
Modify title, description, slug, or color:
Via Your AI Assistant
"Update project abc123-def456 with title 'Q1 Roadmap (Updated)'"
Via API
See Update Project API for request/response details.
Completing Projects
Mark a project as completed when all work is done:
Via Your AI Assistant
"Complete project abc123-def456"
Via API
See Complete Project API for request/response details.
Archiving Projects
Archive projects to hide them from default views:
Via Your AI Assistant
"Archive project abc123-def456"
Via API
See Archive Project API for request/response details.
Notes:
- Cannot archive the default project
- Archived projects don't count toward tier limits
- Milestones in archived projects remain accessible
Reopening Projects
Restore completed or archived projects:
Via Your AI Assistant
"Reopen project abc123-def456"
Via API
See Reopen Project API for request/response details.
Use Cases
Feature Development
Organize major features with dedicated projects:
- User Authentication - Login, registration, password reset
- Payment Integration - Checkout, subscriptions, invoicing
- Notifications - Email, push, in-app alerts
Sprint Planning
Create time-boxed projects:
- Sprint 23 - Current sprint work
- Q1 Roadmap - Quarterly goals
Product Areas
Separate by domain:
- Frontend - UI components, styling, UX
- Backend - APIs, database, infrastructure
- DevOps - CI/CD, monitoring, deployments
Best Practices
Organize by Scope
Create projects for:
- Major features (User Auth, Payment Integration)
- Time periods (Q1 Roadmap, Sprint 23)
- Product areas (Frontend, Backend, Infrastructure)
Use Meaningful Slugs
Choose descriptive slugs for easy reference:
✅ user-auth, q1-roadmap, payment-v2
❌ project1, temp, stuff
Color Code Projects
Use colors to visually distinguish project types:
- Blue for features
- Green for maintenance
- Orange for urgent work
Archive Instead of Delete
Archive completed projects to maintain history rather than losing project data.
MCP Tools
Projects are fully supported via MCP tools:
| Tool | Description |
|---|---|
create_project | Create a new project |
list_projects | List projects in a group |
get_project | Get project details |
update_project | Update project metadata |
complete_project | Mark project as completed |
archive_project | Archive a project |
reopen_project | Reopen a completed/archived project |
See Milestones for creating and managing milestones within projects.