> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synscribe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Video shot-list

> Videos still to record, one task each, with beats and length.

Videos to record for pages that don't yet have one. Each page already has an embed slot, so
dropping a recorded URL into the page front-matter (`video:`) and its 🎥 line is a one-line edit.

**Priority order:** self-serve **orientation (2.0.x) + setup (2.1.x) first** — that's where a new
subscriber most needs to *see* it — then keyword/LP tasks, then publish/analytics.

## To record

| Priority | Page                                                        | The one task the video shows                             | Beats                                                                                                                         | Est. length                                                                                                     |
| -------- | ----------------------------------------------------------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| 1        | **2.0.1** The app in 5 minutes                              | A first-run tour so a new operator isn't lost            | sidebar + what each section is · the org concept · where the Pi Agent lives · where work shows up                             | 4–5 min                                                                                                         |
| 1        | **2.0.2** Working across clients                            | Switch orgs and keep client work separate across tabs    | org switcher · per-tab pinning · confirming which client you're on · the mix-up to avoid                                      | 3–4 min                                                                                                         |
| 1        | **2.0.3** Driving Pi well                                   | Send Pi a good task; manage the Agent Inbox / sessions   | anatomy of a good prompt · the Agent Inbox · sessions + sharing · when Pi asks to confirm                                     | 4–5 min                                                                                                         |
| 1        | **2.0.4** Filing work in Pi's VFS                           | Ask Pi to save/file work into the right place            | `/memory/` as the canonical store · MEMORY.md index + SOUL/IDENTITY · "save this to /memory/…" · reading it back              | 4–5 min                                                                                                         |
| 1        | **2.1.1** Create the org & initialize Pi                    | Create a new org and run Pi's onboarding (memory + soul) | create org (admin) · org auto-triggers bootstrap · name/vibe/soul conversation · confirm IDENTITY/SOUL/MEMORY seeded          | 4–6 min                                                                                                         |
| 1        | **2.1.2** Company research & the Product Bible              | Run `company-explorer`, produce the Product Bible        | kick off website research · what it pulls · Pi writes `/memory/{client}-product-bible.md` · review + correct + send to client | 4–5 min                                                                                                         |
| 1        | **2.1.3** Connect Google Search Console                     | Connect a client's GSC and pick the property             | start GSC connect (Settings → Features) · OAuth · select property (incl. URL-prefix) · Test connection                        | 3–4 min                                                                                                         |
| 2        | **2.2.2** Evaluate + SERP-cliff a batch                     | Run a batch through evaluation + the "can we win?" gate  | select a batch · run evaluation · read the SERP-cliff signal · keep/cut decision                                              | 4–5 min                                                                                                         |
| 2        | **2.3.1** Design a landing-page pillar                      | Design a pillar's schema + prompt (ASCII wireframe)      | pick pillar type (horizontal/vertical) · sketch the wireframe · write the prompt/schema · validate before generating          | 5–6 min · *partially covered by the "design high converting website" Loom — record the schema/prompt half only* |
| 2        | **2.3.4** Export a pillar & wire to the site                | Export a pillar (JSON for code, CSV for CMS) and wire it | choose export format · export · drop into code site / CMS · verify live                                                       | 4–5 min · *export/hand-off specifics ❓ in gap register*                                                         |
| 2        | **2.3.5** Landing-page refiners / compliance edits          | Run LP refiners for schema-safe compliance edits         | open the LP · run refiner · review the surgical edit · confirm no data wipe                                                   | 3–4 min                                                                                                         |
| 2        | **2.3.6** Convert a video → vertical landing page           | Turn a video into a vertical LP                          | supply the video · generate the vertical LP · refine · publish                                                                | 3–4 min                                                                                                         |
| 3        | **2.5.1** Publish & set the live URL                        | Publish a page/post and set its live URL                 | publish action · set/confirm live URL · verify it resolves · common pitfalls                                                  | 2–3 min                                                                                                         |
| 3        | **2.5.2** Technical SEO audit                               | Run `account-quality-control` and read the checklist     | run the audit · walk the checklist · triage findings · fix loop                                                               | 4–5 min                                                                                                         |
| 3        | **2.5.3** Index on GSC + submit sitemap (+ Bing)            | Push a new URL for indexing and submit the sitemap       | request indexing on GSC · submit/refresh sitemap · Bing submit · confirm pickup                                               | 3–4 min                                                                                                         |
| 3        | **2.6.3** Reconcile GSC + PostHog into a performance review | Combine GSC + PostHog into one review                    | pull GSC · pull PostHog · reconcile (AI traffic + pillar conversion) · write the review                                       | 4–5 min                                                                                                         |
| 1        | **2.7.1** Set up the evaluator                              | Write a compliance policy for a client and turn it on    | open the Guardrail page · add 3–5 rules (flag + carve-out) · set org context · toggle on for blog/LP                          | 4–5 min                                                                                                         |
| 1        | **2.7.2** Calibrate the evaluator                           | Prove the policy flags the bad and passes the good       | check a known-bad piece (FAIL + why) · check a known-good (PASS) · tighten a carve-out · re-run                               | 4–5 min                                                                                                         |
| 1        | **2.7.4** Refiner vs evaluator                              | Show fix-vs-gate on one piece                            | run a refiner (content changes) · try to publish (gate blocks) · read the violation + suggestion · one-click fix (passes)     | 3–4 min                                                                                                         |
| 1        | **2.7.3** Use the evaluator at publish                      | The block-and-approve flow                               | publish a failing piece (blocked) · view violations · fix or approve the exact version · publish succeeds                     | 3 min                                                                                                           |
| 2        | **2.7.5** Regulated-industry compliance                     | End-to-end claims-safety for a regulated client          | bible do-not-claim list · non-hallucination rule in the pillar prompt · guardrail policy · publish blocked on a bad claim     | 5–6 min                                                                                                         |
| 2        | **2.7.6** Make content fit categories                       | Tag pages into the pillar taxonomy                       | define pillar categories with descriptions · assign a page's category · filter the pillar by category                         | 3–4 min                                                                                                         |
| 3        | **2.8.1** Fix a page that won't rank                        | Diagnose a ranking drop with seo-debug                   | ask Pi to seo-debug the URL · read the diagnosis · pick the fix · re-check                                                    | 4–5 min                                                                                                         |
| 3        | **2.8.2** Get cited by AI                                   | Turn a research trace into keywords/angles               | supply the research trace · mine fan-out queries · pick angles optimized for LLM citation                                     | 3–4 min                                                                                                         |

## Partial-coverage notes (Raymond's call)

* **2.3.1** — the "How to design high converting website" Loom *touches* this but not the exact
  task; a schema/prompt-focused recording is still worth doing.
* **2.6.1** — treated as **covered-enough** by the "Conversion tracking on PostHog" Loom for now;
  record a dedicated dashboard-setup video only if you want it.

## Existing videos (already embedded)

21 videos (2 YouTube + 19 Loom) are already mapped and embedded on their pages — see
`_sources/video-map.md` for the full embed map. Those pages don't need a new recording unless the
flow has changed.
