# Examples

This section contains example Agent Definition Language (ADL) documents. They illustrate the specification and can be used to validate tooling.

:::tip Start Here New to ADL? Start with the [Minimal Example](/spec/examples/minimal.md) to understand the required fields, then explore the [Production Example](/spec/examples/production.md) for a complete implementation. :::

## Example Index[​](#example-index "Direct link to Example Index")

| Example                                    | Description                                          |
| ------------------------------------------ | ---------------------------------------------------- |
| [Minimal](/spec/examples/minimal.md)       | Minimal valid ADL document with only required fields |
| [With Tools](/spec/examples/with-tools.md) | Calculator agent demonstrating tool definitions      |
| [Production](/spec/examples/production.md) | Full production-style agent with all features        |

## Conventions[​](#conventions "Direct link to Conventions")

* Examples are valid against the ADL version they target
* **Format:** YAML or JSON; must be valid JSON (RFC 8259) when processed
* **Encoding:** UTF-8
* **Member names:** `snake_case` (lowercase with underscores)
* **Required members:** `adl_spec`, `name`, `description`, `version`, `data_classification`
* **Versioning:** `adl_spec` and `version` use semantic versioning (`MAJOR.MINOR.PATCH`)
* **Timestamps:** ISO 8601 with timezone (e.g., `2026-02-15T14:30:00Z`)
* **Extensions:** Use the `extensions` object with vendor-namespaced keys

## Quick Reference[​](#quick-reference "Direct link to Quick Reference")

The minimal valid ADL document:

minimal.adl.yaml

```
adl_spec: "0.3.0"

name: Hello Agent

description: A simple greeting agent.

version: "1.0.0"



data_classification:

  sensitivity: public
```

:::info File Extension ADL documents use the `.adl.yaml`, `.adl.json`, or `.adl` file extension. The media type is `application/adl+json`. :::

## Contributing Examples[​](#contributing-examples "Direct link to Contributing Examples")

New examples are welcome! To contribute:

1. Ensure the example conforms to the target spec version
2. Add clear comments explaining the example's purpose
3. Submit a PR with the example

See the [Contributing Guide](/contributing.md) for more information.