All runbooks
runbookuai-explorerredacted view

Device AI Start-Here Refresh Runbook

Synced UAI Explorer runbook documentation from docs/runbooks/device-ai-start-here-refresh.md.

Updated 2026-06-21·Freshness: Reference·No secret-like patterns were observed in this view.

Device AI Start-Here Refresh Runbook

Created: 2026-06-20

Purpose

Install or refresh a safe UAI lab orientation file on primary development devices so future AI sessions start from the same operating truth.

The source of truth is UAI Explorer. The repo copy of START_HERE_UAI_LAB.md is the managed source for the short device-local cache installed by this runbook.

It is orientation material only and must not contain credential values, private keys, tokens, cookies, raw auth files, or external exposure authority.

Targets

  • Windows workstation: C:\Users\scott\START_HERE_UAI_LAB.md
  • UAI Explorer repo copy: C:\Users\scott\uai-explorer\START_HERE_UAI_LAB.md
  • MacBook-Air: /Users/scott/START_HERE_UAI_LAB.md

No-Change Boundaries

  • Do not overwrite project-specific START_HERE.md files.
  • Do not copy raw survey zones, sanitized exports, .env, .ssh, keychains, browser profiles, logs, caches, or session stores.
  • Do not use this workflow to mutate production CT 121 or public routes.
  • Do not include secrets in the start file or evidence.

Refresh Windows Workstation

Copy-Item -LiteralPath C:\Users\scott\uai-explorer\START_HERE_UAI_LAB.md `
  -Destination C:\Users\scott\START_HERE_UAI_LAB.md -Force
Get-FileHash C:\Users\scott\START_HERE_UAI_LAB.md -Algorithm SHA256

Refresh MacBook-Air

Verify reachability:

ssh -o BatchMode=yes -o ConnectTimeout=8 -o StrictHostKeyChecking=no `
  scott@10.0.0.83 "hostname; test -d ~ && pwd"

Copy the file:

scp -o BatchMode=yes -o ConnectTimeout=8 -o StrictHostKeyChecking=no `
  C:\Users\scott\uai-explorer\START_HERE_UAI_LAB.md `
  scott@10.0.0.83:/Users/scott/START_HERE_UAI_LAB.md

Verify:

ssh -o BatchMode=yes -o ConnectTimeout=8 -o StrictHostKeyChecking=no `
  scott@10.0.0.83 `
  "shasum -a 256 ~/START_HERE_UAI_LAB.md; sed -n '1,30p' ~/START_HERE_UAI_LAB.md"

Evidence

Record the local hash, remote hash, target path, device hostname, and whether any target was unreachable in docs/evidence/.

Do not record credentials, shell history, environment values, or raw document contents.