# A1 Documentation

Welcome to the A1 agent compiler documentation.

## Getting Started
- [Installation](getting-started/installation.md) - Install and set up A1
- [Quick Start](getting-started/quick-start.md) - Build your first agent
- [Core Concepts](getting-started/concepts.md) - Understand the architecture

## Core Guides
- [Agents](guide/agents.md) - Define typed agents with schemas
- [Tools](guide/tools.md) - Create and use tools
- [LLM Integration](guide/llm.md) - Work with language models
- [Compilation](guide/compilation.md) - AOT vs JIT compilation
- [Context & History](guide/context.md) - Message tracking and persistence
- [RAG & Data Sources](guide/rag.md) - File systems, databases, and retrieval

## Advanced Topics
- [Strategies](advanced/strategies.md) - Customize generation, verification, cost, and compaction
- [Retry & Validation](advanced/retry.md) - Configure parallel candidates and retries
- [Serialization](advanced/serialization.md) - Persist and restore agents, tools, runtime
- [Observability](advanced/observability.md) - Tracing, metrics, and debugging
- [Criteria](advanced/criteria.md) - Qualitative and quantitative evaluation

## API Reference
- [Runtime](api/runtime.md) - Runtime orchestration
- [Models](api/models.md) - Core data structures
- [Built-in Tools](api/builtin-tools.md) - LLM, Done, and other tools

## Examples
See the [examples/](../examples/) directory for complete working examples.
