Initial scaffold: spec, architecture playbook, and M0 skeleton

README.md

@@ -0,0 +1,33 @@
+# Astrolabe
+
+A browser-based **snippet manager for [Vega-Lite](https://vega.github.io/vega-lite/)
+visualizations**. Author chart specs as JSON, watch them render live, and keep a personal,
+searchable library — fully local, offline-capable, no account.
+
+> Astrolabe is a **spec-driven rebuild** on an architecture adapted from its sibling
+> project Syto. The authoritative behavioral contract lives in [`docs/spec/`](docs/spec/).
+> See [SOUL.md](SOUL.md) for the philosophy and [docs/IMPLEMENTATION-PLAN.md](docs/IMPLEMENTATION-PLAN.md)
+> for the build sequence.
+
+## Stack
+
+Vite · TypeScript · React + Zustand · Monaco · Vega-Lite + vega-embed · IndexedDB · PWA (offline + installable).
+
+## Develop
+
+```bash
+npm install
+npm run dev        # dev server
+npm run build      # typecheck + production build (+ service worker)
+npm run typecheck
+npm test           # Vitest
+```
+
+## Status
+
+**M0 — Skeleton.** Toolchain green (typecheck, tests, build, PWA). The three-pane shell
+renders; features land milestone by milestone per the implementation plan (MVP at end of M1).
+
+## License
+
+TBD.