> ## 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 new`가 생성하는 내용과 템플릿 구성 방식을 설명합니다.

이 페이지는 `act new`로 생성된 레이아웃이 **왜 그렇게 구성되었는지**를 설명합니다.
빠른 시작 이후에 읽으면 프로젝트를 안전하게 확장하는 방법을 이해할 수 있습니다.

## 생성 방식

Act Operator는 `act_operator/scaffold/`에 있는 템플릿을 렌더링해 사용합니다.
템플릿 렌더링에 쓰는 입력값은 `cookiecutter.json`에 정의되어 있습니다:

* `act_name`, `act_slug`, `act_snake`
* `cast_name`, `cast_slug`, `cast_snake`, `cast_pascal`
* `language`

템플릿 파일은 `{{ cookiecutter.* }}` 플레이스홀더를 사용해 해당 값을 파일 이름과 내용에 주입합니다.

## 템플릿 루트(Act 프로젝트)

생성된 Act 프로젝트에는 다음이 포함됩니다:

* Cast 패키지를 위한 `casts/`(각 Cast는 독립적인 그래프)
* Cast 및 노드 테스트가 있는 `tests/`
* AI 협업을 위한 기본 Skills가 있는 `.claude/skills/`
* CI 워크플로가 있는 `.github/workflows/`
* 프로젝트 구성용 `pyproject.toml`
* 그래프 구성용 `langgraph.json`
* 환경 변수용 `.env.example`
* 프로젝트별 지침용 `README.md`

## Cast 패키지 레이아웃

각 Cast는 `casts/<cast>/` 아래에 생성되며 다음 항목을 포함합니다:

```text theme={null}
casts/
  <cast>/
    graph.py
    pyproject.toml
    README.md
    modules/
      agents.py
      conditions.py
      middlewares.py
      models.py
      nodes.py
      prompts.py
      state.py
      tools.py
      utils.py
```

## 템플릿에 포함된 Skills

기본 Skills는 `.claude/skills/` 아래에 스캐폴딩됩니다:

* `architecting-act`
* `developing-cast`
* `engineering-act`
* `testing-cast`

각 Skill에는 AI 도구가 발견하고 따를 수 있는 `SKILL.md` 파일이 포함됩니다.

## 테스트

템플릿에는 두 가지 테스트 영역이 포함됩니다:

* Cast 수준 테스트용 `tests/cast_tests/`
* 노드 수준 테스트용 `tests/node_tests/`

## 다음 단계

<Columns cols={2}>
  <Card title="개요" icon="map" href="/ko/act-operator/overview">
    개념과 용어를 다시 확인하기
  </Card>

  <Card title="빠른 시작" icon="rocket" href="/ko/act-operator/python/quickstart">
    0에서 동작하는 Cast까지 진행하기
  </Card>
</Columns>