# Project-first workflow

How operators start in Projects while account, search, notifications, and docs stay global and permission-gated.

Status: implemented
Version: latest
Review: source-backed

Projects are the primary production workspace for acquisition goals, CRM work, messages, approvals, runs, proof ledger activity, and operator decisions.

Account remains global: Personal Account, Team/Members and roles, Settings with safety caps and approval rules, and Integrations/APIs with connection status are managed outside any single project and remain permission-gated.

Header search returns tenant-scoped global or project-scoped results for projects, contacts, companies, messages, approvals, activity, and docs without rendering secrets. notifications surface pending approvals, failed jobs, provider degradation, replies, spend, and revenue events from scoped read models.

The prominent Docs link stays available in the persistent navigation so operators can verify project-first workflow, live-action gates, and provider readiness without leaving the workspace context.


Source paths:
- `lib/autonomous_agency/agency.ex`
- `lib/autonomous_agency/search.ex`
- `lib/autonomous_agency/notifications.ex`
- `lib/autonomous_agency_web/components/layouts.ex`