Overview

Act Operator is a CLI and project standard for keeping LangGraph 1.0+ projects structured and maintainable. This page is for readers who already know LangGraph but are new to Act Operator. The recommended flow is Install → Quickstart → Template architecture after this overview. You will learn:

• The problem Act Operator solves
• What Act, Cast, Skill, and CLAUDE.md mean
• How the scaffolded structure fits together

​

Why this exists

LangGraph makes it easy to build agentic workflows, but it does not prescribe how to organize them as the project grows. Act Operator makes the structure explicit so graphs stay understandable, testable, and evolvable.

​

How it works

• act new scaffolds an Act project with a consistent layout
• Each Cast is an independent graph package with its own state, nodes, and dependencies
• Skills guide architecture → implementation → testing workflows
• CLAUDE.md captures decisions so AI tools do not guess

​

Key concepts

Act The standardized project structure for a LangGraph application. Cast An independent graph package inside an Act project. Skill Instruction folders that AI tools can discover and follow. CLAUDE.md Design context and specifications for the project and each Cast.

​

Next steps