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

# Compiler and runtime

> How .voss source moves through parser, analyzer, codegen, and voss_runtime.

The `.voss` pipeline emits readable Python.

```text theme={"theme":"github-dark"}
.voss source
  -> parser
  -> AST
  -> analyzer
  -> codegen
  -> Python + voss_runtime
```

## Pipeline stages

| Stage    | Purpose                                                       |
| -------- | ------------------------------------------------------------- |
| Parser   | Turn `.voss` syntax into AST dataclasses                      |
| Analyzer | Check language semantics such as confidence gates and budgets |
| Codegen  | Emit readable Python                                          |
| Runtime  | Provide primitives used by generated Python                   |

## CLI commands

```bash theme={"theme":"github-dark"}
voss check samples/support.voss
voss compile samples/support.voss
voss run samples/support.voss
```

## Generated Python

Generated Python should be readable, diffable, and debuggable. Voss should not hide behavior in an opaque runtime.

## Harness connection

The harness command surface shares the `voss` binary, but it is separate from compiler commands. Use `voss do` for agent tasks and `voss run` for `.voss` programs.