spec/018: adoption readiness — README and onboarding#33

Draft

outergod wants to merge 35 commits into

018-adoption-readiness

Commits on May 7, 2026

docs(spec/018): scaffold adoption-readiness spec with clarifications

outergod
and
claude
committed
docs(spec/018): plan, research, and quickstart artifacts

outergod
and
claude
committed
docs(spec/018): tasks.md — phased breakdown for implementation

outergod
and
claude
committed
docs(spec/018): analyze remediation — F1–F4 from /speckit.analyze

outergod
and
claude
committed
docs(spec/018): T001 — checklists/readme-structure.md skeleton

outergod
and
claude
committed
docs(spec/018): T002 — synthesis.md skeleton

outergod
and
claude
committed
docs(spec/018): T004 — reorder README sections per FR-001

outergod
and
claude
committed
docs(spec/018): T005 — promote badges, dissolve Credibility heading

outergod
and
claude
committed
docs(spec/018): T006 — 30-second mental model section

outergod
and
claude
committed
docs(spec/018): T007 — compress philosophy sections

outergod
and
claude
committed
docs(spec/018): T008 — fold Trust and release model

outergod
and
claude
committed
docs(spec/018): T009 — Architecture and Walkthrough placeholders

outergod
and
claude
committed
docs(spec/018): T010 — verify US1 MVP intermediate state

outergod
and
claude
committed
chore(release): bump 2.2.0 → 2.2.1 for spec/018 packaged-readme surface

outergod
and
claude
committed
chore(flake): add asciinema for spec/018 recording

outergod
and
claude
committed
docs(spec/018): correct --host argument to match examples/03-immich layout

outergod
and
claude
committed
docs(spec/018): T003 — author docs/onboarding-script.sh

outergod
and
claude
committed
docs(spec/018): T017 — Mermaid architecture block

outergod
and
claude
committed
docs(spec/018): T018 — architecture prose for non-Mermaid renderers

outergod
and
claude
committed
docs(spec/018): tune Mermaid layout to avoid PR-preview control overlap
outergod
committed
docs(spec/018): T019 — Mermaid render verified on PR #33

outergod
and
claude
committed
test(spec/018): track FR-001 README rename in distribution test surface

outergod
and
claude
committed
docs(spec/018): T011/T012/T013 — README walkthrough with verbatim plan blocks

outergod
and
claude
committed
docs(spec/018): T014/T015/T016 — record docs/onboarding.cast and link from README

outergod
and
claude
committed
docs(spec/018): T020 — populate structural checklist with runnable per-FR/SC checks

outergod
and
claude
committed
docs(spec/018): T021-T024 + T027 — polish-phase structural pass and final validate

outergod
and
claude
committed
docs(spec/018): re-record cast + refresh re-plan block after PRs #35/#36

outergod
and
claude
committed
docs(spec/018): add inline GIF sidecar + asciinema.org link to README walkthrough

outergod
and
claude
committed
docs(spec/018): re-record cast without sed CR-strip; restore CRLF for playback

outergod
and
claude
committed
docs(spec/018): rebase onto v2.2.4; FR-007 pivots cast to apply-only

outergod
and
claude
committed
docs(spec/018): natively-recorded apply-only cast + GIF; FR-008 admits v3

outergod
and
claude
committed
docs(spec/018): wire asciinema.org cast ID + operator README reorder

outergod
and
claude
committed
docs(spec/018): operator-recorded cast with paginated plan + apply beats

outergod
and
claude
committed

Commits on May 8, 2026