[JacobStephens2]

Summary

Closes #36

README brought up to date for the 0.1.0 release, plus ADR-0003 recording the release decision.

 README.md
   What a Run does
     Status
-      walking skeleton … (except marking a draft ready) …
+      designed behaviour implemented; gaps in open issues
   Install
+    curl … thirdshift-installer.sh | sh   → ~/.local/bin, no Rust
+    cargo install thirdshift             (alternative for Rust users)
     Updating                             (thirdshift update; lists the other kinds of install)
+  Supported platforms                    (Rocky 9.8+, Ubuntu 24.04.3+, WSL2 + Ubuntu 24.04+, macOS Tahoe 26.5.2+ Apple Silicon)
   Prerequisites                          (claude, gh, git only)
-    The Rust toolchain
   Usage
+    update / version / help              (bare words only)
+  Building from source                   (Rust, cargo install --path ., system-wide install, python3 for tests)
+  Releasing                              (bump in a PR → merge → push v<version> tag)
 docs/adr/
+  0003-static-binaries-through-github-releases.md

ADR-0003 gives three reasons for choosing static musl binaries through dist GitHub Releases, mirrored to crates.io, over crates.io alone: installing needs no Rust, a glibc build won't run on Rocky 9, and the crate name is permanent once claimed. CONTEXT.md is unchanged.

Evidence

Docs only, with no code changes.

• Before: the README's Status still said "walking skeleton … (except marking a draft ready)", Install was cargo install --path ., and Rust was a prerequisite.
  After: every acceptance criterion in README for the release, and ADR-0003 #36 is covered. The claims were checked against dist-workspace.toml, .github/workflows/release-smoke.yml, publish-crates.yml, src/main.rs (help text) and src/update.rs (refusal hints). cargo test passes in full.

Merge Danger

Door: two-way

Blast Radius: documentation

Only readers are affected. The Install section points at releases/latest/download/thirdshift-installer.sh, which only works after v0.1.0 is tagged (#38).

Unaddressed findings

Standards

• ADR-0003 is longer than ADR-FORMAT's "1-3 sentences": the issue asks it to record three distinct reasons and the trade-off, and Spec: release thirdshift 0.1.0 as installable binaries #30 calls this decision hard to reverse and likely to puzzle a future reader, so the Consequences are worth keeping.
• "later on thirdshift.app" is speculative generality: that's the stated motivation in Spec: release thirdshift 0.1.0 as installable binaries #30 (create a site for thirdshift at https://thirdshift.app which communicates how it works and has a pressroom / factory / cyberpunk aesthetic #29 depends on it), not an invented need.
• README says git checkout main && git pull, but update.rs prints git pull: the README version is the more explicit form of the same step, and not worth changing the binary's output for.
• The installer URL and update commands are duplicated between the README and src/update.rs: user docs and CLI output naturally both show the command, and a docs change shouldn't pull in a shared source.

Spec

• "The Linux user" became "The user account" (not requested): macOS is now a supported platform, so "Linux user" would be wrong.

🤖 Generated with Claude Code