From de30ce26a3d69d1964f2f04f018d4249c8fe41ed Mon Sep 17 00:00:00 2001 From: hon2y_b22 Date: Thu, 2 Apr 2026 14:20:18 +0900 Subject: [PATCH 1/4] docs: refine README templates for clarity and consistency --- .../{{ cookiecutter.act_slug }}/TEMPLATE_README.md | 3 +-- .../casts/{{ cookiecutter.cast_snake }}/README.md | 8 ++------ 2 files changed, 3 insertions(+), 8 deletions(-) diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md index d93e93d..854a6f3 100644 --- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md +++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md @@ -337,8 +337,7 @@ The structure and tooling of this monorepo template are licensed under the Proac --- -**This template is powered by [Proact0](https://www.proact0.org/)** -{% else %}# Act Template +**This template is powered by [Proact0](https://www.proact0.org/)**{% else %}# Act Template 이 문서는 본 스캐폴드(템플릿)로 생성된 프로젝트를 빠르게 이해하고, 올바르게 사용하는 방법을 안내합니다. diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md index 3a117c6..9d6b452 100644 --- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md +++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md @@ -1,5 +1,4 @@ -{% if cookiecutter.language == 'en' %} -# {{ cookiecutter.cast_name }} Module +{% if cookiecutter.language == 'en' %}# {{ cookiecutter.cast_name }} Module ## Overview This module defines the {{ cookiecutter.cast_name }} LangGraph graph responsible for running and extracting insights. @@ -37,10 +36,7 @@ result = {{ cookiecutter.cast_snake }}_graph().invoke(initial_state) 1. Add new state in `modules/state.py` 2. Add new node classes in `modules/nodes.py` 3. Define agents/conditions/middlewares/tools/prompts/models/utils if needed -4. Wire nodes into the graph in `graph.py` - -{% else %} -# {{ cookiecutter.cast_name }} 모듈 ({{ cookiecutter.cast_name }} Module) +4. Wire nodes into the graph in `graph.py`{% else %}# {{ cookiecutter.cast_name }} 모듈 ({{ cookiecutter.cast_name }} Module) ## 개요 이 모듈은 {{ cookiecutter.act_name }} 의 {{ cookiecutter.cast_name }} 진행 및 통찰 추출을 담당하는 LangGraph Graph입니다. From 4ab1f0f2b1c0d585e7fcf4fac0c1211ba3ad504f Mon Sep 17 00:00:00 2001 From: hon2y_b22 Date: Thu, 2 Apr 2026 14:22:12 +0900 Subject: [PATCH 2/4] docs: improve formatting in README and template files for better readability --- .../scaffold/{{ cookiecutter.act_slug }}/README.md | 3 ++- .../scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md | 6 ++++-- .../casts/{{ cookiecutter.cast_snake }}/README.md | 3 ++- .../casts/{{ cookiecutter.cast_snake }}/pyproject.toml | 6 ++++-- 4 files changed, 12 insertions(+), 6 deletions(-) diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/README.md b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/README.md index 75e34ce..c40f99e 100644 --- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/README.md +++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/README.md @@ -1,4 +1,5 @@ -{% if cookiecutter.language == 'en' %}# Act: {{ cookiecutter.act_name }} +{% if cookiecutter.language == 'en' %} +# Act: {{ cookiecutter.act_name }} A LangGraph-based Act project scaffolded with Act Operator. diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md index 854a6f3..f758514 100644 --- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md +++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md @@ -1,4 +1,5 @@ -{% if cookiecutter.language == 'en' %}# Act Template +{% if cookiecutter.language == 'en' %} +# Act Template This document provides a quick guide to understand and properly use the project generated from this scaffold (template). @@ -337,7 +338,8 @@ The structure and tooling of this monorepo template are licensed under the Proac --- -**This template is powered by [Proact0](https://www.proact0.org/)**{% else %}# Act Template +**This template is powered by [Proact0](https://www.proact0.org/)** +{% else %}# Act Template 이 문서는 본 스캐폴드(템플릿)로 생성된 프로젝트를 빠르게 이해하고, 올바르게 사용하는 방법을 안내합니다. diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md index 9d6b452..71119ce 100644 --- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md +++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md @@ -1,4 +1,5 @@ -{% if cookiecutter.language == 'en' %}# {{ cookiecutter.cast_name }} Module +{% if cookiecutter.language == 'en' %} +# {{ cookiecutter.cast_name }} Module ## Overview This module defines the {{ cookiecutter.cast_name }} LangGraph graph responsible for running and extracting insights. diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/pyproject.toml b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/pyproject.toml index c840a73..9379de9 100644 --- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/pyproject.toml +++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/pyproject.toml @@ -1,7 +1,9 @@ -{% if cookiecutter.language == 'en' %}# Project configuration file +{% if cookiecutter.language == 'en' %} +# Project configuration file # This file defines the dependencies and metadata for the package. # The Python package manager (uv) uses this file to install required packages. -# To add a dependency to this package, use `uv add <> --package {{ cookiecutter.cast_slug }}`.{% else %}# 프로젝트 설정 파일 +# To add a dependency to this package, use `uv add <> --package {{ cookiecutter.cast_slug }}`. +{% else %}# 프로젝트 설정 파일 # 이 파일은 패키지의 의존성과 메타데이터를 정의합니다. # Python 패키지 관리 도구(uv)가 이 파일을 사용하여 필요한 패키지를 설치합니다. # 이 패키지에 종속성을 추가하시려면 `uv add <> --package {{ cookiecutter.cast_slug }}`를 사용합니다.{% endif %} From 861c058e04cee0f58b4f0af0026cffda9d678de1 Mon Sep 17 00:00:00 2001 From: hon2y_b22 Date: Thu, 2 Apr 2026 14:40:31 +0900 Subject: [PATCH 3/4] docs: update README and template files for improved formatting and clarity - Adjusted header formatting in README and TEMPLATE_README files for consistency. - Removed unnecessary comments in pyproject.toml to streamline the project configuration. - Added a section on adding dependencies in the casts README for better guidance. --- .../{{ cookiecutter.act_slug }}/README.md | 3 +-- .../TEMPLATE_README.md | 3 +-- .../{{ cookiecutter.cast_snake }}/README.md | 18 +++++++++++++++--- .../pyproject.toml | 10 ---------- 4 files changed, 17 insertions(+), 17 deletions(-) diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/README.md b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/README.md index c40f99e..75e34ce 100644 --- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/README.md +++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/README.md @@ -1,5 +1,4 @@ -{% if cookiecutter.language == 'en' %} -# Act: {{ cookiecutter.act_name }} +{% if cookiecutter.language == 'en' %}# Act: {{ cookiecutter.act_name }} A LangGraph-based Act project scaffolded with Act Operator. diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md index f758514..d93e93d 100644 --- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md +++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/TEMPLATE_README.md @@ -1,5 +1,4 @@ -{% if cookiecutter.language == 'en' %} -# Act Template +{% if cookiecutter.language == 'en' %}# Act Template This document provides a quick guide to understand and properly use the project generated from this scaffold (template). diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md index 71119ce..97d01d1 100644 --- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md +++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/README.md @@ -1,5 +1,4 @@ -{% if cookiecutter.language == 'en' %} -# {{ cookiecutter.cast_name }} Module +{% if cookiecutter.language == 'en' %}# {{ cookiecutter.cast_name }} Module ## Overview This module defines the {{ cookiecutter.cast_name }} LangGraph graph responsible for running and extracting insights. @@ -33,11 +32,18 @@ initial_state = { result = {{ cookiecutter.cast_snake }}_graph().invoke(initial_state) ``` +## Dependencies +To add a dependency to this package, use: +```bash +uv add --package {{ cookiecutter.cast_slug }} +``` + ## Extending 1. Add new state in `modules/state.py` 2. Add new node classes in `modules/nodes.py` 3. Define agents/conditions/middlewares/tools/prompts/models/utils if needed -4. Wire nodes into the graph in `graph.py`{% else %}# {{ cookiecutter.cast_name }} 모듈 ({{ cookiecutter.cast_name }} Module) +4. Wire nodes into the graph in `graph.py` +{% else %}# {{ cookiecutter.cast_name }} 모듈 ({{ cookiecutter.cast_name }} Module) ## 개요 이 모듈은 {{ cookiecutter.act_name }} 의 {{ cookiecutter.cast_name }} 진행 및 통찰 추출을 담당하는 LangGraph Graph입니다. @@ -71,6 +77,12 @@ initial_state = { result = {{ cookiecutter.cast_snake }}_graph().invoke(initial_state) ``` +## 의존성 추가 +이 패키지에 종속성을 추가하려면 아래 명령어를 사용합니다: +```bash +uv add <패키지명> --package {{ cookiecutter.cast_slug }} +``` + ## 확장 방법 1. `modules/state.py`에 상태값을 추가 2. `modules/nodes.py`에 새 노드 클래스를 추가 diff --git a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/pyproject.toml b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/pyproject.toml index 9379de9..10d4988 100644 --- a/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/pyproject.toml +++ b/act_operator/act_operator/scaffold/{{ cookiecutter.act_slug }}/casts/{{ cookiecutter.cast_snake }}/pyproject.toml @@ -1,13 +1,3 @@ -{% if cookiecutter.language == 'en' %} -# Project configuration file -# This file defines the dependencies and metadata for the package. -# The Python package manager (uv) uses this file to install required packages. -# To add a dependency to this package, use `uv add <> --package {{ cookiecutter.cast_slug }}`. -{% else %}# 프로젝트 설정 파일 -# 이 파일은 패키지의 의존성과 메타데이터를 정의합니다. -# Python 패키지 관리 도구(uv)가 이 파일을 사용하여 필요한 패키지를 설치합니다. -# 이 패키지에 종속성을 추가하시려면 `uv add <> --package {{ cookiecutter.cast_slug }}`를 사용합니다.{% endif %} - [project] name = "{{ cookiecutter.cast_slug }}" version = "0.1.0" From 76ed4ddb8677b7084a649a32f77d8ad00f9dfcdc Mon Sep 17 00:00:00 2001 From: hon2y_b22 Date: Thu, 2 Apr 2026 14:41:14 +0900 Subject: [PATCH 4/4] chore: bump version to 0.5.3 --- act_operator/act_operator/__init__.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/act_operator/act_operator/__init__.py b/act_operator/act_operator/__init__.py index 7225152..43a1e95 100644 --- a/act_operator/act_operator/__init__.py +++ b/act_operator/act_operator/__init__.py @@ -1 +1 @@ -__version__ = "0.5.2" +__version__ = "0.5.3"