# Verist

> Replay + diff for AI decisions

See exactly what changes when you update a prompt or model — before it hits production.

## Table of Contents

### Getting Started

- [Your First Step](/guides/first-step.md)
- [Core Concepts](/concepts/overview.md)
- [Mental Map](/guides/mental-map.md)
- [Getting Started](/getting-started.md)

### Guides

- [Architecture Overview](/guides/architecture.md)
- [Replay and Diff](/guides/replay-and-diff.md)
- [Workflows](/guides/workflows.md)
- [Storage and State](/guides/storage.md)
- [Human Overrides](/guides/overrides.md)
- [Error Handling](/guides/errors.md)
- [Batch Runs](/guides/batch.md)
- [Suspend and Resume](/guides/suspend-resume.md)
- [Pipelines](/guides/pipeline.md)
- [Anti-Patterns](/guides/anti-patterns.md)

### Integrations

- [Integrations](/integrations.md)
- [LangExtract](/integrations/langextract.md)

### Other

- [ADR-001: Deterministic State Machine Over Autonomous Agents](/adr/001-determinism.md)
- [ADR-002: Declarative Commands for Control Flow](/adr/002-commands.md)
- [ADR-003: State Layers](/adr/003-state-layers.md)
- [ADR-004: Replay Semantics](/adr/004-replay-semantics.md)
- [ADR-005: Package Stability Tiers](/adr/005-package-stability.md)
- [ADR-006: Command Categories](/adr/006-command-categories.md)
- [ADR-007: Unified run() API](/adr/007-unified-run-api.md)
- [ADR-008: Artifact Capture Hook in Core](/adr/008-artifact-capture-hook.md)
- [ADR-009: Pipeline Error Handling and Audit Trail](/adr/009-pipeline-error-handling.md)
- [ADR-010: Execution Loop with Outbox Pattern](/adr/010-execution-loop.md)
- [ADR-011: Consolidate core + replay into single `verist` package](/adr/011-package-consolidation.md)
- [ADR-012: Structured Step Errors via `fail()`](/adr/012-structured-step-errors.md)
- [ADR-NNN: \[Short, Actionable Title]](/adr/000-template.md)
- [CI Integration](/guides/ci-integration.md)
- [FAQ](/faq.md)
- [Glossary](/glossary.md)
- [Identity-Aware Array Diff](/notes/plan.local.md)
- [Reference Runner](/guides/reference-runner.md)
- [SPEC: Commands](/specs/commands.md)
- [SPEC: Kernel Invariants](/specs/kernel-invariants.md)
- [SPEC: Overview](/specs/overview.md)
- [SPEC: Replay](/specs/replay.md)
- [SPEC: Steps](/specs/steps.md)
- [SPEC: Suspend/Resume](/specs/suspend.md)
- [TypeScript Declaration Files (.d.ts) Generation Plan](/notes/dts-generation-plan.local.md)
- [Verist: Next Steps (Impact Plan)](/notes/next-steps.local.md)
- [Why Verist](/why-verist.md)