96168fa24f
Replace incorrect README icon with actual Atlas app icon, add new screenshots (about, settings, privilege), improve feature view responsiveness and empty states, adjust design system brand tokens and localization strings, add icon generation script. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Atlas for Mac Docs
This directory contains the working product, design, engineering, and compliance documents for the Atlas for Mac desktop application.
Principles
- Atlas for Mac is an independent product.
- The project does not use the Mole brand in user-facing naming.
- The project may reuse or adapt parts of the upstream Mole codebase under the MIT License.
- User-facing flows should prefer explainability, reversibility, and least privilege.
Document Map
PRD.md— product requirements and MVP scopeIA.md— information architecture and navigation modelArchitecture.md— application architecture and process boundariesProtocol.md— local JSON protocol and core schemasTaskStateMachine.md— task lifecycle rulesErrorCodes.md— user-facing and system error registryROADMAP.md— 12-week MVP execution planBacklog.md— epics, issue seeds, and board conventionsDECISIONS.md— frozen product and architecture decisionsRISKS.md— active project risk registerExecution/— weekly execution plans, status snapshots, beta checklists, gate reviews, manual test SOPs, and release execution notesExecution/Current-Status-2026-03-07.md— current engineering status snapshotExecution/UI-Audit-2026-03-08.md— UI design audit and prioritized remediation directionsExecution/UI-Copy-Walkthrough-2026-03-09.md— page-by-page UI copy glossary, consistency checklist, and acceptance guideExecution/Execution-Chain-Audit-2026-03-09.md— end-to-end review of real vs scaffold execution paths and release-facing trust gapsExecution/Smart-Clean-Execution-Coverage-2026-03-09.md— user-facing summary of what Smart Clean can execute for real todayExecution/Smart-Clean-QA-Checklist-2026-03-09.md— QA checklist for scan, execute, rescan, and physical restore validationExecution/Smart-Clean-Manual-Verification-2026-03-09.md— local-machine fixture workflow for validating real Smart Clean execution and restoreTemplates/— issue, epic, ADR, gate, and handoff templatesWORKSPACE_LAYOUT.md— planned repository and module structureHELP_CENTER_OUTLINE.md— help center structureCOPY_GUIDELINES.md— product voice and UI copy rulesATTRIBUTION.md— upstream acknowledgement strategyTHIRD_PARTY_NOTICES.md— third-party notices and license referencesADR/— architecture decision recordsSequence/— flow-level engineering sequence documents
Ownership
- Product decisions:
Product Agent - Interaction and content design:
UX Agent - App implementation:
Mac App Agent - Protocol and domain model:
Core Agent - XPC and privileged integration:
System Agent - Upstream adaptation:
Adapter Agent - Verification:
QA Agent - Distribution and release:
Release Agent - Compliance and docs:
Docs Agent
Update Rules
- Update
PRD.mdbefore changing MVP scope. - Update
Protocol.mdandTaskStateMachine.mdtogether when task lifecycle or schema changes. - Add or update an ADR for any process-boundary, privilege, or storage decision.
- Keep
ATTRIBUTION.mdandTHIRD_PARTY_NOTICES.mdin sync with shipped code.