GetHub/CleanMM
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
main
CleanMM/Docs/README.md

66 lines
4.1 KiB
Markdown
Raw Permalink Normal View History

feat: add Atlas native app UX overhaul
2026-03-10 17:09:35 +08:00
# 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 scope
- `IA.md` — information architecture and navigation model
- `Architecture.md` — application architecture and process boundaries
- `Protocol.md` — local JSON protocol and core schemas
- `TaskStateMachine.md` — task lifecycle rules
- `ErrorCodes.md` — user-facing and system error registry
fix: harden internal beta execution trust
2026-03-12 19:18:41 +08:00
- `ROADMAP.md` — active internal-beta hardening roadmap and conditional release branch
feat: add Atlas native app UX overhaul
2026-03-10 17:09:35 +08:00
- `Backlog.md` — epics, issue seeds, and board conventions
- `DECISIONS.md` — frozen product and architecture decisions
- `RISKS.md` — active project risk register
- `Execution/` — weekly execution plans, status snapshots, beta checklists, gate reviews, manual test SOPs, and release execution notes
- `Execution/Current-Status-2026-03-07.md` — current engineering status snapshot
docs: add internal beta hardening week execution plan
2026-03-12 23:13:59 +08:00
- `Execution/Internal-Beta-Hardening-Week-2026-03-16.md` — one-week execution plan for clean-machine QA and Smart Clean hardening
fix: harden internal beta execution trust
2026-03-12 19:18:41 +08:00
- `Execution/Release-Roadmap-2026-03-12.md` — internal-beta hardening plan plus conditional signed release path
feat: add Atlas native app UX overhaul
2026-03-10 17:09:35 +08:00
- `Execution/UI-Audit-2026-03-08.md` — UI design audit and prioritized remediation directions
- `Execution/UI-Copy-Walkthrough-2026-03-09.md` — page-by-page UI copy glossary, consistency checklist, and acceptance guide
- `Execution/Execution-Chain-Audit-2026-03-09.md` — end-to-end review of real vs scaffold execution paths and release-facing trust gaps
fix: harden internal beta execution trust
2026-03-12 19:18:41 +08:00
- `Execution/Implementation-Plan-ATL-201-202-205-2026-03-12.md` — implementation plan for internal-beta hardening tasks ATL-201, ATL-202, and ATL-205
feat(smart-clean): add structured targetPaths to ActionItem for execution 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
2026-03-13 00:49:32 +08:00
- `Execution/Execution-Credibility-Gate-Review-2026-03-12.md` — gate review for ATL-211, ATL-212, and ATL-215 Smart Clean execution credibility work
fix: enforce recovery retention and fail-closed restore semantics - prune expired recovery items on load/save and reject expired restores at worker boundary - add restoreExpired and restoreConflict protocol/application error mapping - disable expired restore actions in History and reload persisted state after restore failures - add recovery expiry/conflict coverage plus sync protocol, architecture, state-machine, and recovery contract docs - wire AtlasAppTests into the shared Xcode scheme and add app-layer regression coverage for expired restore reload behavior Refs: ATL-221 ATL-222 ATL-223 ATL-224 ATL-225, vibe-kanban SID-9
2026-03-13 10:35:15 +08:00
- `Execution/Recovery-Contract-2026-03-13.md` — frozen recovery semantics, claim boundaries, and acceptance evidence for ATL-221 through ATL-224
- `Execution/Recovery-Credibility-Gate-Review-2026-03-13.md` — gate review for ATL-221 through ATL-225 recovery credibility work
feat(landing): add Atlas landing page with Astro static site Implement the full landing page for atlas.atomstorm.ai per the PRD at Docs/Execution/Landing-Page-PRD-2026-03-14.md. Includes design spec, bilingual Astro site, CI pipeline, and all assets. Key deliverables: - DESIGN.md: 7-section Atom Web Design specification - Astro 5.x static site with 15 components and 11 page sections - Bilingual i18n (zh/en) with path-based routing - Build-time GitHub release manifest integration - Release channel state machine (Stable/Prerelease/Coming Soon) - CSS design tokens mapped from AtlasBrand.swift - Self-hosted fonts (Space Grotesk, Instrument Sans, IBM Plex Mono) - OG social sharing images for both locales - GitHub Actions workflow for GitHub Pages deployment - Zero client JS, 227KB page weight, 17/17 quality checks passed Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 10:18:27 +08:00
- `Execution/Landing-Page-PRD-2026-03-14.md` — PRD for the public landing page, GitHub Pages deployment, custom domain strategy, and launch-surface requirements
feat: add Atlas native app UX overhaul
2026-03-10 17:09:35 +08:00
- `Execution/Smart-Clean-Execution-Coverage-2026-03-09.md` — user-facing summary of what Smart Clean can execute for real today
- `Execution/Smart-Clean-QA-Checklist-2026-03-09.md` — QA checklist for scan, execute, rescan, and physical restore validation
- `Execution/Smart-Clean-Manual-Verification-2026-03-09.md` — local-machine fixture workflow for validating real Smart Clean execution and restore
- `Templates/` — issue, epic, ADR, gate, and handoff templates
- `WORKSPACE_LAYOUT.md` — planned repository and module structure
- `HELP_CENTER_OUTLINE.md` — help center structure
- `COPY_GUIDELINES.md` — product voice and UI copy rules
- `ATTRIBUTION.md` — upstream acknowledgement strategy
- `THIRD_PARTY_NOTICES.md` — third-party notices and license references
- `ADR/` — architecture decision records
- `Sequence/` — 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.md` before changing MVP scope.
- Update `Protocol.md` and `TaskStateMachine.md` together when task lifecycle or schema changes.
- Add or update an ADR for any process-boundary, privilege, or storage decision.
- Keep `ATTRIBUTION.md` and `THIRD_PARTY_NOTICES.md` in sync with shipped code.
Reference in New Issue Copy Permalink