Tutorials

Tutorials build one complete thing from an empty directory. Each takes 30–60 minutes and ends with something running.

Tutorial 1 — An inbox briefing service

Build a service that produces a morning brief from documents and calendar: scaffold with mynd init, schedule a daily y0-fast run with both context sources, render run.result.summary to email. Covers run creation, context scoping, and reading traces when the brief misses something.

Tutorial 2 — Invoice extraction pipeline

Upload PDFs to /v1/files, wait for file.processed webhooks, extract line items with y0-vision against a strict schema, and land rows in your database with idempotency keys so retries never double-insert. Covers files, webhooks, schemas, and idempotency.

Tutorial 3 — A gated follow-up agent

An agent that drafts overdue-invoice follow-ups but never sends without sign-off: tools ["email.send", "finance.read"], approval required on email.send, a small approval UI polling run.pending_actions. Covers agent runs, approval gates, and the audit log.

Tutorial 4 — Regression-gated prompts in CI

Export ten known-good traces, commit them as fixtures, and wire mynd traces replay --fail-on-diff plus an eval-suite run into CI so no prompt change ships on vibes. Covers trace export, replay, and judge thresholds.

# .github/workflows/evals.yml (the relevant step)
- run: mynd traces replay fixtures/*.trace.json --fail-on-diff
- run: mynd evals run suite_release_gate --min-score 0.85