- Use ProjectAtlas repository intelligence before broad filesystem searches or full-file reads.
- When ProjectAtlas MCP tools are available, call
atlas_session_briefonce with the current task and compact output, then follow its returned next call. Initialize withatlas_initonly when the project atlas is absent, and refresh it only when it may be stale. - With the CLI fallback, narrow through
projectatlas overview,projectatlas folders, andprojectatlas files; then usesummary,outline,search, orslicefor the selected file. - After repository changes, refresh with
projectatlas watch --onceand validate withprojectatlas lint --report-untracked --purpose-level low. - Treat
.projectatlas/projectatlas.dbas authoritative local state. Update purposes throughprojectatlas purpose setorprojectatlas purpose review; never edit the database directly.