App — Projects

Field	Value
Status	GA
Owner	@aphaiboon
Sidekick-accessible	Read + write

What it is

The natural unit of “a thing the team is doing.” Bigger than a task, smaller than a strategic initiative. A Project bundles:

• Threads — long-lived focused conversations (see Sidekick → Threads)
• Tasks — work items (see Tasks)
• Brain docs — durable knowledge (spec, RFC, research)
• Calendar events — kickoff, milestones, ship date
• Members — who’s involved

Hierarchy: Projects ⊇ Threads ⊇ Chats.

Lifecycle

Status	Meaning
Planning	Brainstorm / spec phase
Active	Being executed
Blocked	External dependency
Shipped	Done — moved to archive after 30 days
Cancelled	Won’t be done; reasoning preserved

Views

• Projects list — all projects, filterable by status + member
• Project detail — overview tab + Threads tab + Tasks tab + Brain tab + Activity tab
• Toolbar uses icon-only segmented control for tab switching
• Uses StandardPage wrapper

Sidekick integration

Capability	Tool
Create project	create_project
Update project	update_project
Link chat to project	link_chat_to_project
Query projects	query_projects
Project summary	summarize_project

Context tag: @project — attaches project overview + recent tasks + recent threads.

Data model

Table	Purpose
projects	Project rows
project_members	Membership
project_threads	Thread links
project_tasks	Task links (via task.projectId)
project_brain_docs	Brain doc links

Permissions

Projects can be private (members only), team (team-wide), or workspace (anyone in org). Enforced at repository level via organizationId + membership checks.

Related incidents

• FM-045 — Cross-workspace personal surfaces 403s

Related

• App — Tasks — Tasks roll up to Projects
• App — Sidekick — Threads live inside Projects
• App — Brain — Project specs / research docs
• App — Calendar — Project milestones
• App — Strategy & Goals — Projects tie to quarterly Rocks