> ## Documentation Index
> Fetch the complete documentation index at: https://docs.proact0.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Act Operator

> Scaffold and scale LangGraph projects with confidence

> **Scaffold structured LangGraph 1.0+ projects and keep them maintainable as they grow.**

Act Operator is a **CLI and project standard** for teams that already know LangGraph
but want a clean, repeatable project structure.
It introduces Acts and Casts as project units and provides AI Skills to keep architecture, development,
and testing aligned as the project grows.

If your LangGraph project:

* Started clean, but became hard to reason about
* Grew beyond a single graph and turned messy
* Was difficult to test, refactor, or explain to another developer

**Act Operator exists to solve exactly that.**

If this is your first time seeing Act Operator, read in this order:

* **Overview**: the problem it solves and the core concepts
* **Install**: prerequisites and scaffolding
* **Quickstart**: create a project and verify the flow
* **Template architecture**: understand the generated structure

## Why Act Operator

LangGraph makes it easy to build agentic workflows.
What it does not give you is a standard way to organize them as they grow.

Act Operator provides:

* A clear, modular structure for state, nodes, agents, and tools
* A scalable way to manage multiple graphs as Cast packages
* AI-native development via built-in Skills and explicit project context
* Opinionated defaults that reduce architectural guesswork

## 30-second quick start

Requires Python 3.11+.

```bash theme={null}
uvx --from act-operator act new
```

New here? Start with **Overview**, then follow **Install → Quickstart**.

## How it works

* `act new` scaffolds a standardized Act project
* Each Cast is an independent graph package with explicit boundaries
* CLAUDE.md files store design context for humans and AI tools
* Skills guide architecture, implementation, and testing workflows

## What is an Act

An **Act** is a structured, modular unit of a LangGraph application.

Think of it as:

* A bounded graph with a clear purpose
* A package with explicit state, nodes, agents, and dependencies
* A design artifact that can be reasoned about, tested, and refactored
* A collaboration surface for both humans and AI agents

Multiple Acts (called Casts) can live together in a single repository,
forming a maintainable monorepo for complex agentic systems.

## Built for AI collaboration

Act Operator is designed for AI-assisted development from day one.

Each project includes built-in Skills that allow AI tools to:

* Understand your architecture before generating code
* Ask the right questions instead of guessing
* Follow consistent implementation and testing patterns
* Evolve existing graphs without breaking structure

## Next steps

Pick a path based on where you are:

<Columns cols={2}>
  <Card title="Overview" icon="map" href="/en/act-operator/overview">
    Concepts, features, and target use cases.
  </Card>

  <Card title="Install" icon="download" href="/en/act-operator/python/install">
    Install and setup details for Python projects.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/en/act-operator/python/quickstart">
    Go from zero to a working cast fast.
  </Card>

  <Card title="Template architecture" icon="sitemap" href="/en/act-operator/python/template-architecture">
    Understand the generated structure and conventions.
  </Card>
</Columns>