# Monata Documentation

Monata is a lightweight EDA framework for circuit design. It organizes designs
with a Library/Cell/View hierarchy, runs simulations through selected SPICE
backends, and connects results to measurements, specs, sweeps, corners, Monte
Carlo, and optimization.

This documentation is organized by role:

## Getting Started

Start here if you want a short path from installation to a first simulation.

## User Guide

The user guide is the main Monata workflow:

- organize projects, libraries, cells, and views
- author schematic and testbench views
- attach technology models and choose a simulator backend
- run `SimTask` objects with executors
- evaluate results with measurements and specs
- run sweeps, corners, Monte Carlo, and optimization

## Toolchain

Toolchain pages explain the external tools behind Monata's current and planned
backend work. The current native milestone is ngspice subprocess execution with
explicit OpenVAF/OSDI model preparation; other simulators are deferred roadmap
items. Public Monata releases recommend asking a skill-aware coding agent to use the public
`lizhangmai/skills` `monata-sim-env` and `conda-build` skills, build or reuse a
user-owned local conda channel, then consume that channel from pixi instead of
shipping private third-party binaries.

## Reference

Reference pages collect API boundaries, model compatibility, BSIM background,
and technical details that are useful when choosing models or debugging backend
behavior.

## Maintainers

Maintainer pages collect roadmap, contribution, security, release notes, and
packaging notes that should not clutter the package source repository.

```{toctree}
:maxdepth: 2
:caption: Contents

getting-started/index
user-guide/index
tutorials/index
examples/index
toolchain/index
reference/index
maintainers/index
```