1d4dbeb370
ActionItem now carries optional targetPaths so plan.execute can use plan-carried targets instead of reconstructing execution intent from findings. This improves execution reliability and enables proper restore mappings for recovery items. - Add targetPaths field to ActionItem domain model - Update plan execution to prefer plan-carried targets with finding fallback - Expand safe cache path fragments for direct-trash execution - Add gate review documentation for ATL-211/212/215 - Bump protocol version to 0.3.0
3.7 KiB
3.7 KiB
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— active internal-beta hardening roadmap and conditional release branchBacklog.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/Internal-Beta-Hardening-Week-2026-03-16.md— one-week execution plan for clean-machine QA and Smart Clean hardeningExecution/Release-Roadmap-2026-03-12.md— internal-beta hardening plan plus conditional signed release pathExecution/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/Implementation-Plan-ATL-201-202-205-2026-03-12.md— implementation plan for internal-beta hardening tasks ATL-201, ATL-202, and ATL-205Execution/Execution-Credibility-Gate-Review-2026-03-12.md— gate review for ATL-211, ATL-212, and ATL-215 Smart Clean execution credibility workExecution/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.