# Docs Overview

oagen documentation is organized by adoption stage.

## Core

Start here if you want to understand or use the framework itself:

- [Core Index](core/index.md)
- [Minimal Quickstart](core/quickstart.md)
- [CLI Reference](cli.md)
- [Emitter Contract](architecture/emitter-contract.md)
- [IR Type System Reference](architecture/ir-types.md)
- [Pipeline Architecture](architecture/pipeline.md)

## Advanced

Read these when you need migration or verification workflows beyond basic generation:

- [Advanced Index](advanced/index.md)
- [Workflows](architecture/workflows.md)
- [Extractor Contract](architecture/extractor-contract.md)
- [Non-Additive Changes](architecture/non-additive-changes.md)
- [`transformSpec` — Pre-IR Spec Overlay](advanced/transform-spec.md)

## Agent Task Guides

Focused guides for AI agents working on specific areas of the codebase:

- [Architecture & Core Contracts](agents/architecture.md)
- [Emitter Implementation](agents/emitters.md)
- [Testing & Smoke Validation](agents/testing.md)

## Contributor

Read these if you are maintaining oagen itself or depending on its public API surface:

- [Contributor Index](contributor/index.md)
- [Public API Policy](contributor/public-api.md)
- [Versioning and Migration](contributor/versioning.md)
- [Dependency Layers](architecture/dependency-layers.md)