README, docs and site: one story (the whole job, no avoidable rejections, the desktop app, your AI, install)

README is a short front page (about 120 lines) with one real visual per section; every former section moved
unchanged into docs/*.md with a docs/README.md index (journey, rejections, getting-started, commands, growth,
studios, store-art, listing-languages, api, skills, mcp, safety, faq, project). The site tells the same story on one
page: the teaser in the hero, real CLI output as text, the desktop app as a section with light/dark captures of eight
screens and the per-system downloads (desktop/latest.json); /desktop/ redirects to /#download. New capture tools:
tools/site-desktop-shots.ts (fixture-mode desktop frames) and tools/site-term-shots.ts (real CLI output as text and
WebP). tests/docs-links.test.ts checks README, docs and site links resolve.

docs/README.md

@@ -0,0 +1,40 @@
+# storebound docs
+
+The [README](../README.md) is the short tour; everything in detail lives here.
+
+## Start
+
+- [Getting started](getting-started.md): the 5-minute quick start, coming from fastlane, credentials, install for your AI tool
+- [The journey](journey.md): why storebound, how agents use it, every step from setup to Submit (API, console or yours)
+- [FAQ](faq.md)
+
+## Ship
+
+- [Commands](commands.md): every command, grouped (setup and checks, Google Play, App Store, TestFlight, after launch,
+  screenshots and video, many apps and release trains)
+- [Catch rejections before you submit](rejections.md): `storebound scan`, every rule with its guideline or policy
+- [Store art](store-art.md): screenshots and previews, fonts, variants, video
+- [Listing in more languages](listing-languages.md)
+- [Growth extras and console forms](growth.md): PPP prices, Apple Ads, web presence, ad-hoc builds, RevenueCat,
+  `console plan` / `console verify` / `console fill`
+- [Many apps, studios, release trains and workflows](studios.md)
+- [Every endpoint](api.md): `storebound api` and the [API coverage](api-coverage.md) table
+
+## Agents and safety
+
+- [Rules for AI agents](agents-core.md) (the source of `AGENTS.md`)
+- [Skills](skills.md)
+- [MCP server and the desktop machine interface](mcp.md)
+- [Safety model](safety.md)
+- [Idempotency: every write converges](idempotency.md)
+- [Pitfalls: lessons from real use](pitfalls.md)
+
+## Desktop app
+
+- [storebound desktop](desktop.md): design, safety model, screens
+- [Releasing storebound desktop](desktop-release.md): build, sign, check, publish
+
+## Project
+
+- [Roadmap, contributing and credits](project.md) (agent support details, what is not verified yet, develop)
+- [Research notes](research/fastlane-revenuecat.md)