Local Development

If you want to work on ado-aw itself, a local Rust-based development setup is enough for most compiler and documentation tasks.

Prerequisites

Install or update Rust:

rustup toolchain install stable
rustup default stable
rustc --version  # must be 1.94.0 or later

Use the standard Rust workflow while developing:

cargo test
cargo clippy

These commands help catch regressions and style issues before you commit changes.

Compile an example or your own agent file:
Terminal window
```
cargo run -- compile path/to/agent.md
```
Verify the generated YAML matches the source definition:
Terminal window
```
cargo run -- check path/to/agent.lock.yml
```

A common local development loop for compiler work:

Build the project:
Terminal window
```
cargo build
```
Run the test suite:
Terminal window
```
cargo test
```
Compile a test agent to verify your changes:
Terminal window
```
cargo run -- compile path/to/agent.md
```
Verify the compiled output matches expectations:
Terminal window
```
cargo run -- check path/to/agent.lock.yml
```

The docs site lives in site/ and is built with Astro + Starlight.