개요

LangGraph 1.0+ 프로젝트를 더 구조적으로 관리하고 커져도 유지보수 가능하게 만들기 위해, Act Operator가 CLI 및 프로젝트 표준을 제공합니다. 이 페이지는 “LangGraph는 알지만 Act Operator는 처음”인 분을 위한 개요입니다. 이 개요를 읽은 뒤에는 설치 → 빠른 시작 → 템플릿 아키텍처 순으로 보는 것을 권장합니다. 이 페이지에서 알게 되는 것:

• Act Operator가 해결하는 문제
• Act, Cast, Skill, CLAUDE.md의 의미
• 스캐폴딩된 구조가 어떻게 맞물리는지

​

왜 필요한가

LangGraph는 에이전틱 워크플로를 쉽게 만들 수 있지만, 프로젝트가 커질 때 어떻게 조직할지는 알려주지 않습니다. Act Operator는 구조를 명시해 그래프가 이해 가능하고 테스트 가능하며 확장 가능한 상태로 유지되도록 합니다.

​

작동 방식

• act new가 일관된 레이아웃의 Act 프로젝트를 스캐폴딩합니다
• 각 Cast는 자체 상태, 노드, 의존성을 가진 독립 그래프 패키지입니다
• Skills가 아키텍처 → 구현 → 테스트 워크플로를 안내합니다
• CLAUDE.md가 의사결정을 기록해 AI 도구가 추측하지 않게 합니다

​

핵심 개념

Act LangGraph 애플리케이션을 위한 표준화된 프로젝트 구조입니다. Cast Act 프로젝트 내부의 독립적인 그래프 패키지입니다. Skill AI 도구가 발견하고 따라갈 수 있는 지침 폴더입니다. CLAUDE.md 프로젝트와 각 Cast에 대한 설계 컨텍스트와 명세입니다.

​

다음 단계