Learn Laufwerk
A chapter-by-chapter guide to agents, code, human decisions and durable workflows.
Agents do the work, code defines the process, and people make the decisions. This guide develops the README's chapters into small lessons you can read in order or open when you need a particular concept.
Each chapter explains one part of the system, shows a concrete example and links to the detailed API contract. The final chapter combines the ideas in a complete research-and-draft workflow with human review and one permitted revision.
Choose your route
- New to Laufwerk? Run Hello World, then start with the system overview.
- Building something now? Start with the chapter matching your question below.
- Looking up a property? Use the API reference.
- Want a full example first? Open research and draft, or issue to fix for a coding workflow.
The chapters
Understand the system
- The system at a glance — See what runs where and how a request becomes a result.
- Projects, workflows and runs — Define and run a small process with a stable identity.
Build the process
- Agents, tools and skills — Give a reusable role the capabilities it needs.
- Sessions and shared files — Choose a fresh conversation, a continuation or shared files.
- Structured data and real checks — Separate usable output from an accepted result.
- Branches, loops and parallel work — Control order, concurrency and revision limits in code.
- Human input and review — Turn decisions and feedback into durable workflow input.
Keep work reliable
- Durability, waiting and recovery — Understand recorded work and uncertain external outcomes.
- Execution and isolation — Choose file, credential and resource boundaries.
- Context and memory — Make handoffs explicit and retrieve the evidence you need.
- Studio, logs and usage — Inspect a run and interpret the available measurements.
Evaluate and connect
- Evidence and reusable cases — Preserve the problem, candidate and its review together.
- Compare workflow changes — Run fixed cases through alternatives and score outcomes.
- Applications, HTTP and ownership — Connect your application to the runtime.
Put it together
- A complete research-and-draft workflow — Combine the pieces in a runnable, bounded review process.
How to use the examples
These lessons target 0.0.1-alpha.13. Complete workflow files include their imports and registration. Helpers say where to call them; tests say where to save and run them. TypeScript and TSX examples are checked against the exact published packages, including relative imports between files on the same page.
Examples with agents require provider access and may use native tools. Pure workflows and tests are identified so you can learn without making model calls. Proposed dataset and benchmark APIs are distinguished from the ordinary code you can run today. See current status for verification limits.