Everything in mseries/, grouped by what you are trying to do. Work in progress: the installer and the
enhancement layer are the current focus, the factory-ISO documents describe an unverified path.
Installing and recovering (start here)
Document
What it covers
REINSTALL-RUNBOOK.md Wipe, reinstall with elementary-mac-setup, what to expect, what to bring back if it fails
BACKUP-AND-REINSTALL.md Backing up before a reinstall
POST-BOOT-CHECKS.md Checklist after the first boot (trackpad, Wi-Fi, keys, display, video)
DESKTOP-SETUP.md Desktop tweaks, shortcuts, optional extras
Work Mode panel Native System Settings toggle, Blue Flow work wallpaper, and weekday schedule
FIRMWARE-WIFI.md Wi-Fi firmware provisioning
USB-C-DOCK-DP-ALT-MODE.md External displays through a dock
Power, battery and dock investigations Start with the power documentation map for current evidence, branch ownership and next steps.
Document
What it covers
TRANSFORM-DESIGN.md Design and safety contract of the in-place cut-over (transform/elementary-grow.sh)
KERNEL-FLOW.md How the Asahi kernel, initramfs and GRUB boot elementary
STORAGE-PLAN.md Partition and subvolume layout
PORT-MAP.md Which omarchy-mac fixes were ported to Ubuntu/Pantheon, and what is out of scope
UPSTREAM-PINS.md Pinned upstream revisions and licences
PLATFORM-PLAN.md Proposal: split into kernel/display/wm/SDK repos, an SDK a small model can build apps with, pipeline and phases
ARCH-REBASE-PLAN.md Decision and phased plan to rebase the platform on Arch Linux (Asahi Alarm): what gets simpler, caveats, decisions
ASAHI-ALARM-AUDIT-2026-10-23.md Audit of the Asahi Alarm base: maintainers, repo address, versions vs upstream, cadence, risks
MINIMAL-SYSTEM.md Layered minimum system: every package mapped to Arch/Asahi/ours/drop with why and the leanest form; Rust Pantheon replacement order
SDK-PARITY.md Frozen baselines (T3 original, Signal, Image Studio), unified standards, the parity score and the LLM pass loop
GTK-PERFORMANCE-ASAHI.md What keeps GTK4/Granite apps small and idle on Asahi (renderer, CSD shadow, cursor blink, animations, D-Bus), with every GTK app here listed
DEV-HYGIENE.md Keeping the dev machine clean: the weekly dev-clean timer (build output, caches, session scratch, dated Codex exports), one shared cargo target dir, worktree discipline
SMART-REPLY-DESIGN.md Design only: a window-aware agent that drafts replies in any app (Tab inserts, Esc discards), what it reuses from dictation and the SDK, safety rules, and a scoped first slice
SDK-AGENT-SURFACE.md Design only: SDK apps declare intents, entities, scopes and risk classes (like Apple's App Intents and entitlements); msdk validates them and generates the MCP manifest; the broker enforces user grants
Document
What it covers
OS9-HANDOFF.md Latest state, audit notes, verification results, blockers, next task
ROADMAP.md Open problems and stretch goals
OMARCHY-M-ROADMAP.md Owner sequence: follow Omarchy M sources, integrate and qualify code, then migrate to Rust with measurements
ATOMIC-APP-DEPLOYMENT.md Requested atomic app updates, rollback, apt performance investigation and Flatpak/Nix evaluation
UPDATER-DESIGN.md Customer update mechanism: signed repo, channels, staged apply at next login, automatic rollback, owner decisions
BUG-FIX-ROADMAP.md Upstream comparison and prioritised bug backlog
OMARCHY-AUDIT-2026-10.md Audit of omarchy-mac
UPGRADE-SURVEY-2026-10-18.md Pinned-vs-latest upgrade table, Aurora Silicon release lanes, upstream and own WIP branch merge recommendations
Factory ISO and VMs (unverified on hardware) Build reviews and reports (history) BUILD-38396499561-REVIEW.md , BUILD-ERROR-REVIEW-2026-10-13.md ,
OPENCODE-BUILD-REPORT.md , ICONIDENTIFY-REPOSITORY-REVIEW.md ,
JOSHUA-REPOSITORY-REVIEW.md .