[alukach]

Moves the repository's helper folders out of the top level. This changes nothing a user of the CLI sees: no commands, no output, no guide pages.

What moved

demo/                        →  docs/recorder/
  README.md, record.py,          README.md, record.py, stub.py,
  stub.py, check_stub.py,        check_stub.py, fixtures.json,
  fixtures.json                  guide.py
  demos/guide.py
preview/install.sh           →  .github/preview/install.sh

The top level goes from three helper folders (demo/, docs/, preview/) to one, docs/:

• docs/recorder/. The recorder only produces docs/demos/, so it lives beside it. guide.py, the one kept demo script, moves up from its own demos/ folder. The git-ignored casts/ and scripts/ follow it (.gitignore updated).
• .github/preview/install.sh. Only the Preview build workflow uses it: it checks out just that file, sets the preview's name in it and attaches it to the pre-release. Putting it in .github/ also ends a clash between two meanings of "preview": preview builds of the CLI, and the docs' PR previews (pr-preview/pr-N/).
• What stays put. docs/site/ and docs/demos/ don't move. The README's images link to docs/demos/*.svg, and the Docs workflow republishes a release by running docs/site/build.py from that release's tag, so moving it would break republishing older versions.

Follow-on changes

• Path references: about 55, in AGENTS.md, CONTRIBUTING.md, the recorder's README and scripts, docs/site/assets/player.js (a comment), and the Stub matches the API and Preview build workflows (path filters, run:, checkout and sed).
• Docs workflow: now ignores docs/recorder/**, so a change only to the recorder builds no docs preview. That's how it behaved when the recorder sat outside docs/.
• AGENTS.md: now names the one kept script, docs/recorder/guide.py, where it used to name a demos/ folder.

Testing

• uv run --with jsonschema python docs/recorder/check_stub.py: every route ok against staging's spec.
• python3 -I docs/recorder/record.py docs/recorder/guide.py tour: recorded into docs/recorder/casts/, the new default output folder, which git ignores.
• uv run --with markdown-it-py python docs/site/build.py --out target/site: 15 pages and 31 demos, as before.
• cargo test: 165 passed. All three edited workflows parse as YAML.
• Not tried: the Preview build workflow's publish path, which runs only on main. This PR exercises its build-only path, since it changes .github/preview/install.sh.

🤖 Generated with Claude Code

[claude]

Claude finished @alukach's task in 11s —— View job

---

I'll analyze this and get back to you.

---

💰 Estimated review cost: $0.15 · 0m10s · 3 turns

[github-actions]

Docs preview: https://source-cooperative.github.io/source-coop-cli/pr-preview/pr-83/

Built from baef685. It goes live a minute or two after the Docs deploy run, and is removed when the PR closes.