The Corvid Book
Sequential learning material. Read top to bottom on your first pass; come back to specific chapters as reference later.
Table of contents
- Why Corvid — the moat in three minutes.
- Install — get Corvid on your machine.
- Quickstart — first program in five minutes.
- Tutorial: build a refund agent — end-to-end walkthrough exercising every shipped invention.
- Syntax basics — narrative intro to the language shape.
- Types — primitives, generics, structs, sum types.
- Modules and imports — multi-file projects, visibility.
- Effects — the load-bearing primitive.
- Approve — compile-time approval tokens.
- Grounded — provenance-carrying types.
- Agents — composable program entry points.
- Prompts — LLM-backed functions.
- Errors and Result — recoverable vs unrecoverable failures.
- Pattern matching — exhaustive match, destructuring.
- Project layout —
corvid.tomland conventions. - Testing —
test,eval,fixture,mock. - Building and targets — native, wasm, server, cdylib.
- Replay — deterministic re-execution.
After the book
When you finish the book, the next stop depends on what you’re building:
- An HTTP backend → guides/backend.md.
- A persistence layer → guides/persistence.md.
- A durable agent → guides/jobs.md.
- An auth layer → guides/auth.md.
- Production deployment → operations/production-checklist.md.