diff --git a/README.md b/README.md
index e242e6f..dc0377f 100644
--- a/README.md
+++ b/README.md
@@ -7,14 +7,26 @@ sources of differing quality: **Qobuz** (lossless/hi-res), **Soulseek** (P2P),
 
 ## Status
 
-Early design. Built in three slices:
+Built in three slices:
 
-1. **Acquisition engine** — *in progress*. Given an album/track, find the best
-   available source, download it, tag it against MusicBrainz, and file it into a
-   clean library.
-2. **Library manager** — Lidarr-style monitoring, wanted lists, auto-grab of new
-   releases.
-3. **Discovery** — Spotify/recommendation-driven finding of new music.
+1. **Acquisition engine** — ✅ **done**. Resolve a request against MusicBrainz,
+   match/rank across Qobuz/Soulseek/YouTube, download the best source into an
+   isolated staging dir, verify completeness, tag (mutagen), and atomically promote
+   the clean album into `Artist/Album (Year)/## Title.ext`.
+2. **Library manager** — ✅ **done**. Watched artists (live MB search + follow),
+   per-release monitor toggles + auto-monitor-future, a wanted list with retry +
+   quality-upgrade window, and a worker "monitor" that discovers new releases and
+   auto-grabs through the acquisition pipeline. Plus a **library scan** that ingests
+   existing on-disk albums as have + monitored + followed, and a per-artist
+   studio-only / show-all release-type filter.
+3. **Discovery** — ⬜ **not started**. Spotify/recommendation-driven finding of new music.
+
+**Operational notes:** the monitor is **off by default** — set `monitor.enabled=true`
+(+ optional `monitor.*` tuning) in the `Config` table to activate auto-grab/upgrade.
+Credentials are entered in Settings and persist across `docker compose up -d --build`
+rebuilds (don't use `down -v`). Tests run against a separate `lyra_test` database (a
+guard blocks the live DB). Deferred hardening + the full roadmap live in the
+implementation-plan "Notes" sections under [`docs/superpowers/plans/`](docs/superpowers/plans/).
 
 ## Architecture